树莓派后台运行Python脚本无法读取GPIO按键输入问题求助

我碰到过好几个类似的树莓派GPIO按键监听的问题，你的情况大概率是GPIO事件处理逻辑的阻塞/误触发或者后台运行环境的输出/信号问题，咱们一步步来排查：

1. 先排除硬件与基础GPIO检测问题 #

先脱离你原来的复杂逻辑，写个极简测试脚本验证GPIO引脚能不能正确检测按键输入：

import RPi.GPIO as GPIO
import time

# 设置BCM引脚编号模式
GPIO.setmode(GPIO.BCM)
# 配置引脚为输入，启用内部下拉电阻（防止悬空误触发）
GPIO.setup(23, GPIO.IN, pull_up_down=GPIO.PUD_DOWN)
GPIO.setup(24, GPIO.IN, pull_up_down=GPIO.PUD_DOWN)

try:
    while True:
        if GPIO.input(23) == GPIO.HIGH:
            print("Button 23 pressed")
            time.sleep(0.2)  # 按键消抖，避免机械抖动触发多次
        if GPIO.input(24) == GPIO.HIGH:
            print("Button 24 pressed")
            time.sleep(0.2)
        time.sleep(0.01)  # 降低CPU占用
finally:
    GPIO.cleanup()  # 退出时清理GPIO配置

运行这个脚本后手动按按键，看终端有没有输出：

• 如果没输出：先查硬件——按键是不是接了3.3V（别接5V，会烧GPIO）和对应引脚，有没有接触不良；也可以换个GPIO引脚测试，排除引脚损坏的可能。
• 如果有输出：说明硬件没问题，问题出在你原脚本的逻辑或者后台运行配置上。

2. 排查原脚本的阻塞与误触发点 #

你提到修改代码后会重复打印x并调用updateMission.js，这说明大概率是消抖逻辑缺失或者事件处理的阻塞问题：

关于消抖 #

如果用的是GPIO中断（add_event_detect），一定要加bouncetime参数，比如：

GPIO.add_event_detect(23, GPIO.RISING, callback=your_button_func, bouncetime=200)

没有消抖的话，按键按下时的机械抖动会触发几十次回调，导致重复执行操作。

关于阻塞 #

如果你的回调函数里有耗时操作（比如调用updateMission.js用了subprocess.run()），这个方法会等待命令执行完成才返回，期间整个GPIO事件循环会被阻塞，导致后续按键检测失效。可以改成subprocess.Popen()让它后台执行：

# 替换原来的subprocess.run()
subprocess.Popen(['node', 'updateMission.js'])

如果用的是轮询方式，循环里一定要加短休眠（比如time.sleep(0.01)），不然会占满CPU，导致系统卡顿出现假阻塞。

3. 后台运行的环境坑点 #

你是用什么方式让脚本后台运行的？比如nohup python mission_buttons.py &或者systemd服务？

• 如果用nohup：默认stdout会被重定向到nohup.out文件，你之前说按下没反应，可能是打印的x没在终端显示，而是写到了这个文件里，去看看nohup.out有没有内容。
• 如果用systemd：日志会存在journal里，用journalctl -u your-service-name查看输出，同时要确保服务配置里的用户属于gpio组，不然会没有GPIO访问权限。
• 权限问题：不管用哪种方式，都要确保运行脚本的用户（比如pi）属于gpio组，执行sudo usermod -aG gpio pi后重启生效，避免因权限不足无法访问GPIO。

4. 修复后的参考脚本 #

结合以上要点，给你一个防阻塞、防误触发的参考版本：

import RPi.GPIO as GPIO
import subprocess
import time
import threading

# 用线程锁防止同一按键多次触发
button_lock = threading.Lock()

def handle_button(channel):
    # 尝试获取锁，非阻塞模式避免等待
    if button_lock.acquire(blocking=False):
        try:
            if channel == 23:
                print('x')
            elif channel == 24:
                # 非阻塞调用js脚本
                subprocess.Popen(['node', 'updateMission.js'])
        finally:
            # 不管有没有异常，都释放锁
            button_lock.release()

# GPIO初始化
GPIO.setmode(GPIO.BCM)
GPIO.setup(23, GPIO.IN, pull_up_down=GPIO.PUD_DOWN)
GPIO.setup(24, GPIO.IN, pull_up_down=GPIO.PUD_DOWN)

# 添加事件检测，带消抖
GPIO.add_event_detect(23, GPIO.RISING, callback=handle_button, bouncetime=200)
GPIO.add_event_detect(24, GPIO.RISING, callback=handle_button, bouncetime=200)

try:
    # 主进程保持运行，等待事件触发
    while True:
        time.sleep(1)
except KeyboardInterrupt:
    # 捕获中断信号，清理GPIO
    GPIO.cleanup()

最后排查步骤总结 #

1. 用极简脚本验证硬件GPIO是否正常
2. 检查原脚本的消抖逻辑和耗时操作是否阻塞
3. 确认后台运行的输出路径和权限问题
4. 用线程锁防止按键重复触发

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