使用gpiozero控制树莓派3B+的Flask应用Heroku部署问题问询

你遇到的报错本质是两个核心问题：

1. Heroku的容器运行环境没有本地GPIO硬件，gpiozero默认会自动检测并尝试加载本地引脚驱动，找不到就直接抛出异常
2. Heroku的公网服务器默认无法直接访问你内网环境下的树莓派，远程连接链路不通

可行解决方法 #

方案一：继续在Heroku部署服务

• 强制指定远程引脚工厂
  在所有gpiozero相关导入语句的最前面，先通过环境变量显式指定使用远程pigpio工厂，禁止自动检测本地驱动，示例代码如下：

  import os
  # 必须写在gpiozero导入之前
  os.environ['GPIOZERO_PIN_FACTORY'] = 'pigpio'
  # 读取Heroku环境变量里的树莓派配置，不要硬编码敏感信息
  os.environ['PIGPIO_ADDR'] = os.getenv('PI_PUBLIC_ADDR')
  os.environ['PIGPIO_PORT'] = os.getenv('PI_PIGPIO_PORT', '8888')
  os.environ['PIGPIO_PASSWORD'] = os.getenv('PI_PIGPIO_PASSWORD', '')
  
  from gpiozero import LED
  # 后续编写你的引脚控制逻辑
  

• 把树莓派暴露到公网
  你可以通过端口映射、frp、ngrok等方式，把树莓派上pigpiod服务默认的8888端口映射到公网，保证Heroku服务器可以访问到该端口。记得给pigpiod设置访问密码，避免被恶意控制。
• 适配依赖配置
  在项目根目录的requirements.txt里仅声明通用依赖，不要添加仅树莓派环境才能安装的包（比如RPi.GPIO），示例依赖配置：

  Flask==2.3.3
  gpiozero==2.0
  pigpio==1.78
  gunicorn==20.1.0
  

• 添加异常捕获逻辑
  在树莓派连接相关代码块外增加异常捕获，避免连接失败直接导致服务崩溃，方便排查问题的同时可以给前端返回友好提示。

方案二：换部署架构（更简单稳定）

你可以直接把Flask服务部署在树莓派本地，仅把树莓派的网页服务端口（80/443）映射到公网，不需要跨环境调用gpiozero，不存在硬件检测和网络连通性问题，部署门槛更低，运行稳定性更高。

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