Ubuntu下Python程序无法处理systemd重启时的KillSignal问题排查

1. 关机阶段的超时问题 #

Systemd关机时会先发送SIGTERM，但如果进程在默认超时时间内未退出，会直接发送SIGKILL强制终止。如果你的LED恢复逻辑耗时过长，可能还没执行完就被干掉了。

• 解决：在systemd服务文件中添加TimeoutStopSec=10s（可根据实际调整时长），确保信号处理函数有足够时间执行；优先优化恢复逻辑的执行速度，避免依赖修改FinalKillSignal规避强制终止。

2. Python主循环阻塞信号处理 #

Python的信号处理依赖解释器的主循环间隙，如果你的程序是纯CPU密集型死循环，没有调用time.sleep()或其他让出GIL的操作，信号处理函数会无法被触发。

• 解决：在主循环中加入短暂休眠（比如time.sleep(0.1)），给解释器留出处理信号的窗口。

3. Systemd服务Type不匹配 #

如果服务配置的Type与程序运行方式不符，会导致systemd无法正确跟踪进程，信号发送对象错误。比如用Type=forking但程序未后台化，或Type=simple但程序自行后台运行。

• 解决：若Python程序是前台运行，明确设置Type=simple，且不要在ExecStart命令后加&让程序后台化。

4. 信号处理函数注册过晚 #

如果信号处理函数是在程序启动后期才注册的，可能在注册完成前就收到了信号，导致未被处理。

• 解决：在程序启动初期（导入必要模块后立刻）注册信号处理函数。

5. 权限不足导致恢复逻辑失败 #

LED控制通常需要root权限，如果systemd服务运行的用户没有对应权限，信号处理函数中的LED恢复操作会执行失败，看起来像是信号未被接收。

• 解决：在服务文件中添加User=root，或者将运行用户加入LED设备所属的用户组（比如gpio组，依硬件而定）。

6. KillMode设置干扰 #

默认KillMode=control-group会终止整个控制组的进程，如果程序启动了子进程，可能主进程的信号处理被干扰；若设置KillMode=process则仅终止主进程，需确保程序是单进程结构。

• 解决：根据程序的进程结构调整KillMode，单进程程序用KillMode=process更稳妥。

7. 信号处理未触发的验证 #

先排除逻辑问题，确认信号处理函数是否被调用：

• 在信号处理函数中添加日志输出，比如print("Received SIGTERM, resetting LED")；
• 用journalctl -u your-service-name查看systemd日志，或实时查看journalctl -u your-service-name -f；
• 手动测试：执行sudo systemctl stop your-service-name，观察日志是否有信号处理的记录，先验证正常停止服务时的逻辑，再排查关机场景。

修正后的配置与代码示例 #

Systemd服务文件（/etc/systemd/system/led-control.service）

[Unit]
Description=LED Control Service
After=multi-user.target

[Service]
Type=simple
ExecStart=/usr/bin/python3 /path/to/your/led_script.py
KillSignal=SIGTERM
TimeoutStopSec=10s
User=root
Restart=on-failure

[Install]
WantedBy=multi-user.target

Python代码核心部分

import signal
import time
import sys

def reset_led(signum, frame):
    print(f"Received signal {signum}, resetting LED to default...")
    # 替换为你的LED恢复逻辑，比如 set_led_rgb(0, 0, 0)
    sys.exit(0)

# 尽早注册信号处理
signal.signal(signal.SIGTERM, reset_led)
signal.signal(signal.SIGINT, reset_led)
signal.signal(signal.SIGHUP, reset_led)

def main():
    while True:
        # 你的LED控制业务逻辑
        # ...
        # 必须加入休眠，让解释器处理信号
        time.sleep(0.1)

if __name__ == "__main__":
    main()

内容的提问来源于stack exchange，提问作者Madz