树莓派3B+上Domoticz调度Python脚本报错：No module named 'serial'

从你的场景和环境变量对比来看，核心问题是Domoticz运行脚本时的Python环境和你用Thonny调试的环境存在差异，导致系统找不到serial库。下面是一步步排查和解决的方案：

1. 先确认Domoticz用的是Python3而非Python2 #

这是最常见的坑：如果Domoticz默认调用Python2，那你通过sudo apt-get install python3-serial安装的库肯定不兼容。

在你的测试脚本开头加两行代码：

import sys
print(f"Python执行路径: {sys.executable}")
print(f"Python版本: {sys.version}")

通过Domoticz调度执行后查看日志，如果输出是Python2（比如路径是/usr/bin/python），就去Domoticz设置里调整：

• 进入Domoticz的「Event System」选项卡
• 在「Python Command」字段填写/usr/bin/python3，保存后重启Domoticz

2. 手动添加serial库的安装路径到Python搜索列表 #

用apt安装的python3-serial一般在系统级库目录，比如/usr/lib/python3/dist-packages，但Domoticz的Python环境可能没把这个路径加入搜索范围。

先在终端确认serial库的位置：

dpkg -L python3-serial | grep serial/__init__.py

输出会类似/usr/lib/python3/dist-packages/serial/__init__.py

然后在脚本里import serial之前添加路径：

import sys
# 替换成上面命令得到的路径（去掉末尾的/__init__.py）
sys.path.append('/usr/lib/python3/dist-packages')
import serial

3. 用pip3重新安装pyserial（备选方案） #

有时候apt安装的库会有路径兼容性问题，试试用pip3装系统级的pyserial：

sudo pip3 install pyserial

这会确保serial库被安装到所有用户都能访问的路径，Domoticz的Python环境就能直接找到它。

4. 验证root用户的Python环境能否导入serial #

Domoticz通常以root身份运行，你可以直接在终端模拟这个场景：

sudo python3 -c "import serial; print('导入成功')"

如果这条命令能正常输出「导入成功」，说明root用户的Python环境没问题，Domoticz运行脚本也应该能正常导入serial。

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