c++中如何处理SIGTERM信号以实现程序的优雅退出？ (信号处理)

裘德小鎮的故事

发布时间：2026-01-15 16:06:09

377人浏览过

来源于php中文网

原创

不能直接用 signal() 注册 SIGTERM 处理函数，因其行为跨平台不一致、默认重置处理方式且不保证异步信号安全；应使用 sigaction() 配合 volatile std::sig_atomic_t 标志和主循环检查实现安全退出。

c++中如何处理sigterm信号以实现程序的优雅退出？ (信号处理)

为什么不能直接用 signal() 注册 SIGTERM 处理函数？

因为 signal() 行为在不同系统上不一致（POSIX vs. BSD），且默认会重置信号处理方式，导致第二次 SIGTERM 可能被忽略或触发默认终止。更严重的是，signal() 不保证信号安全——在处理函数中调用 printf、std::cout、new 等非异步信号安全函数会引发未定义行为。

必须改用 sigaction()，它可精确控制信号掩码、标志位，并保证可重入性。

如何用 sigaction 安全注册 SIGTERM 处理器？

核心是：只做最少必要操作（设标志位），其余清理逻辑放在主循环中检查。以下是最小可靠模板：

volatile std::sig_atomic_t g_terminate_requested = 0;

void sigterm_handler(int sig) {
    if (sig == SIGTERM) {
        g_terminate_requested = 1;  // 只写 sig_atomic_t，异步信号安全
    }
}

int main() {
    struct sigaction sa;
    sa.sa_handler = sigterm_handler;
    sigemptyset(&sa.sa_mask);      // 不额外屏蔽其他信号
    sa.sa_flags = SA_RESTART;      // 让被中断的系统调用自动重启
    sigaction(SIGTERM, &sa, nullptr);

    while (!g_terminate_requested) {
        // 主工作循环（如网络收发、定时任务）
        // 注意：sleep()/poll()/epoll_wait() 等可被信号中断，需检查返回值
        poll(nullptr, 0, 1000);  // 示例：每秒检查一次退出标志
    }

    // 此处执行所有非信号安全的清理：关闭文件、释放内存、日志落盘等
    cleanup_resources();
    return 0;
}

g_terminate_requested 必须是 volatile std::sig_atomic_t 类型，确保写入不会被编译器优化掉，且是原子读写
SA_RESTART 很关键：否则 poll()、read() 等可能返回 -1 并设 errno = EINTR，需手动重试
绝对不要在 sigterm_handler 里调用 std::cout、free()、pthread_cancel() 等非 async-signal-safe 函数

多线程环境下 SIGTERM 怎么投递给正确线程？

Linux 中信号默认投递给进程的任意一个未屏蔽该信号的线程。如果主线程屏蔽了 SIGTERM，而工作线程没屏蔽，就可能由工作线程接收——但工作线程通常没注册 handler，结果进程直接终止。

立即学习“C++免费学习笔记（深入）”；

动态WEB网站中的PHP和MySQL：直观的QuickPro指南第2版

动态WEB网站中的PHP和MySQL详细反映实际程序的需求，仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法，让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能，对常用的、强大的包

下载

解决方案是：在 所有线程创建前，用 pthread_sigmask() 屏蔽 SIGTERM，然后在主线程中用 sigwait() 或 signalfd()（Linux 特有）同步等待：

// 主线程初始化时：
sigset_t set;
sigemptyset(&set);
sigaddset(&set, SIGTERM);
pthread_sigmask(SIG_BLOCK, &set, nullptr);  // 阻塞 SIGTERM

// 后续在主线程循环中：
int sig;
sigwait(&set, &sig);  // 同步等待，安全，可调用任意函数
if (sig == SIGTERM) {
    g_terminate_requested = 1;
}