Nvidia Jetson（Ubuntu）开机自启Python脚本第三方模块导入失败问题

问题背景 #

用户在~/.config/autostart/路径创建了自启配置文件myscript.desktop，配置内容如下：

[Desktop Entry]
Encoding=UTF-8
Name=myscript
Comment=myscript
Icon=gnome-info
Exec=python /your/path/script.py
Terminal=false
Type=Application
Categories=

X-GNOME-Autostart-enabled=true
X-GNOME-Autostart-Delay=0

实际运行表现为：

• 脚本仅调用Python内置模块时，自启运行完全正常
• 脚本导入matplotlib.pyplot、tensorflow、firebase等第三方库时，自启场景下报错No module named tensorflow、No module named matplotlib.pyplot、No module named firebase
• 用户已确认所有依赖库在系统Python路径下，手动运行脚本时可正常调用

分步排查与解决方法 #

1. 验证自启配置调用的Python解释器是否与安装依赖的解释器一致 #

这是该场景下最高发的触发原因，尤其在Jetson设备搭载的Ubuntu系统上，默认python命令往往指向Python 2.7解释器，与用户日常通过pip install/pip3 install安装依赖的Python 3解释器并非同一个。

• 排查操作：在终端依次执行命令，确认解释器指向与依赖安装位置：
  • 执行which python、which python3，记录两个命令返回的解释器绝对路径
  • 执行python -c "import tensorflow; print(tensorflow.__file__)"、python -c "import matplotlib.pyplot; print(matplotlib.__file__)"，验证自启配置里默认调用的python解释器是否能找到对应依赖
• 修正方案：将.desktop文件中Exec字段的解释器替换为安装过目标依赖的解释器绝对路径，避免依赖环境变量的PATH匹配。例如将原Exec=python /your/path/script.py修改为Exec=/usr/bin/python3.8 /home/你的用户名/projects/script.py

2. 排查自启场景下的环境变量加载不全问题 #

桌面自启触发的应用进程，不会像用户手动登录终端那样自动加载.bashrc、.profile文件中定义的自定义环境变量，经常出现Python库路径、CUDA依赖路径加载缺失，导致第三方库识别失败。

• 排查操作：将.desktop中Exec行修改为带日志输出的形式，收集自启运行时的实际环境信息：
  Exec=/usr/bin/python3 /home/你的用户名/projects/script.py > /home/你的用户名/autostart_run.log 2>&1
  触发自启后打开日志文件，对比手动在终端运行脚本时打印的sys.path列表、环境变量取值，定位缺失的路径项
• 修正方案：
  • 直接在脚本代码开头，手动将缺失的库路径追加到sys.path列表中
  • 调整Exec行的运行方式，通过登录式Shell加载全量用户环境变量：Exec=bash -lc '/usr/bin/python3 /home/你的用户名/projects/script.py'

3. 核对用户级安装的库路径权限与可见性 #

如果第三方库是通过pip install --user 包名的方式安装，所有库文件会存放在当前用户的~/.local/lib/pythonx.x/site-packages目录下：

• 排查操作：执行python3 -m site，查看返回结果中USER_SITE字段的路径值，确认该路径是否包含已安装的第三方库
• 修正方案：确保自启进程的运行用户与安装依赖的用户完全一致，避免出现"用root权限安装依赖、用普通用户触发自启运行"的用户身份错配，防止路径权限不足导致的模块识别失败

注意：Jetson设备上的tensorflow、matplotlib等带硬件加速的依赖，需要匹配对应JetPack版本的安装包，不可直接使用通用PyPI源的安装包替代，否则会出现手动运行报错的问题。

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