树莓派4上Python温湿度脚本终端正常但经PHP调用时DHT11报GPIO访问错误
核心问题本质
这个问题完全不是Python脚本逻辑的bug,根因是两种执行场景下的进程运行身份、权限上下文存在本质差异,和脚本里DS18B20采集、外网IP获取、数据库上报、邮件告警这类依赖网络、普通文件权限的功能没有关联:
- 终端直接运行脚本时,进程是由你登录的树莓派普通用户(通常为
pi)启动的,该用户默认已被加入GPIO硬件访问相关的系统用户组,拥有直接操作板载GPIO引脚的权限,所有硬件访问流程可以正常执行。 - 通过PHP的
shell_exec调用脚本时,进程的运行身份是Web服务的内置默认用户(绝大多数场景下为www-data),该用户默认没有被加入树莓派的硬件访问权限组,不具备访问/dev/gpiochip0、/dev/mem等DHT11传感器驱动依赖的硬件节点的权限,内核会在GPIO初始化、传感器电平读取阶段直接拦截进程操作,最终抛出RuntimeError: Error accessing GPIO异常。 - 这个异常只会在硬件操作环节触发的特性,也能解释为什么你脚本里的网络请求、数据库连接、邮件发送这类不需要硬件权限的功能都能正常运行,唯独走到DHT11读取步骤就报错。
落地排查与修复步骤
- 先确认PHP调用的实际运行身份:在原有PHP代码里临时插入一行执行
echo shell_exec('whoami');,访问对应PHP页面输出的用户就是实际拉起Python脚本的进程身份,用于后续权限配置。 - 给Web服务运行用户授予硬件访问权限,执行命令将用户加入树莓派预设的硬件访问组:
sudo usermod -a -G gpio,dialout,i2c,spi 你的PHP运行用户名
(如果上一步查到的用户是www-data,就直接替换命令里的用户名即可) - 权限变更完成后必须重启对应的服务才能生效:用Apache的重启Apache服务,用Nginx搭配PHP-FPM的重启对应版本的PHP-FPM服务,否则新的用户组权限不会被加载到Web运行进程的上下文里。
- 完成权限配置后不要直接跑完整业务脚本,先写10行以内的极简测试代码验证DHT11的GPIO访问是否正常,确认没有权限报错之后再接入完整业务逻辑。
- 注意:不要为了图省事直接给Web运行用户分配root权限执行Python脚本,这种操作会带来极高的服务器安全风险,也不要依赖临时的
chmod修改硬件节点权限的方案,重启系统后权限会自动重置,问题会复现。
内容的提问来源于stack exchange,提问作者Videobazis
相关产品推荐
相关产品推荐

