Python服务中KeyboardInterrupt含os.system()导致无法正常停止的问题

核心原因 #

当systemd向Python服务进程发送SIGINT触发KeyboardInterrupt后，在异常处理中调用os.system()或subprocess.run()创建子进程时，通常会遇到两类问题：

• systemd默认以控制组为单位管理服务，子进程会被纳入同一控制组，导致systemd判定服务仍在运行，直至超时后强制杀死整个组。
• 嵌入式环境下的set_led脚本可能因缺失终端环境变量、隐性权限问题或自身阻塞逻辑，导致子进程无法正常退出，进而卡住Python主进程。

可行解决方案 #

1. 确保子进程快速退出并隔离 #

修改subprocess调用参数，强制子进程与主进程控制组分离，并设置超时防止卡住：

import subprocess
import os

try:
    while True:
        # 主业务逻辑
        ...
except KeyboardInterrupt:
    # 其他清理逻辑
    ...
    try:
        # 调用set_led，分离控制组+超时限制
        subprocess.run(
            ['/usr/local/bin/set_led', '2', 'OFF'],
            timeout=3,  # 设置3秒超时，避免脚本卡住
            close_fds=True,  # 关闭主进程的文件描述符，防止子进程持有systemd关联资源
            preexec_fn=os.setpgrp  # 创建新进程组，脱离systemd控制组管理
        )
    except subprocess.TimeoutExpired:
        # 超时处理，可记录日志
        pass

2. 调整systemd服务配置 #

在你的.service文件中添加以下配置，让systemd正确识别服务退出状态：

[Service]
KillSignal=SIGINT
SuccessExitStatus=INT  # 告知systemd收到SIGINT属于正常退出
KillMode=process       # 仅杀死主进程，不强制终止子进程（需确保子进程能自行退出）

3. 直接在Python中实现LED控制（最可靠） #

如果set_led只是简单的GPIO电平操作，建议直接在Python内实现，彻底规避子进程问题。例如基于sysfs操作GPIO：

def set_led(led_num, state):
    # 假设LED 2对应GPIO路径为/sys/class/gpio/gpioX，需替换为实际路径
    gpio_path = f"/sys/class/gpio/gpio{led_num}"
    with open(f"{gpio_path}/value", 'w') as f:
        f.write('0' if state == 'OFF' else '1')

try:
    while True:
        ...
except KeyboardInterrupt:
    ...
    set_led(2, 'OFF')

4. 排查set_led脚本本身 #

若必须保留外部脚本，可捕获其输出排查问题：

result = subprocess.run(
    ['/usr/local/bin/set_led', '2', 'OFF'],
    capture_output=True,
    text=True
)
# 将输出写入日志文件，查看是否有报错
with open('/tmp/led_log.txt', 'w') as f:
    f.write(f"STDOUT: {result.stdout}\nSTDERR: {result.stderr}")

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