开机启动脚本环境变量丢失的根本原因是执行环境与交互式shell不同:systemd默认不加载用户配置文件,rc.local以root运行且path固定,crontab@reboot环境极简,导致path、home等关键变量缺失,需按启动方式显式设置或用bash -l等方式主动加载。

开机启动脚本环境变量丢失,不是脚本写错了,而是它压根没活在你熟悉的 shell 环境里。手动能跑、开机就报 command not found 或 No module named xxx,十有八九是 PATH、HOME、PYTHONPATH 这类关键变量根本没加载进来。
一、先确认:脚本到底运行在什么环境里?
别猜,直接抓现场。在你的启动脚本最开头加一行:
env > /tmp/startup_env.log 2>&1然后重启系统,再登录查看这个文件:
cat /tmp/startup_env.log对比你在终端里执行 env 的输出,重点看这几项:
-
PATH:是否只有
/usr/bin:/bin,缺了/usr/local/bin、~/.local/bin或 conda 路径? -
HOME:是不是空的,或是
/root(即使你配的是普通用户)? -
SHELL:是不是
/bin/sh(非 bash/zsh),导致 ~/.bashrc 完全不生效? - USER / LOGNAME:是否符合预期?systemd 默认可能不设这些变量。
二、按启动方式对症下药
不同机制加载环境的方式完全不同,不能一套配置打天下:
-
systemd 服务:默认不读任何用户配置文件。必须显式设置:
[Service]
Environment="PATH=/usr/local/bin:/usr/bin:/bin:/home/user/.local/bin"
Environment="HOME=/home/user"
Environment="USER=user" -
/etc/rc.local:以 root 身份运行,PATH 固定,但可主动加载 profile:
. /etc/profile
. /home/user/.profile
su - user -c "/home/user/myscript.sh" -
crontab @reboot:环境极简,建议用完整路径 + 显式 source:
@reboot /bin/bash -l -c 'source /home/user/.bashrc && /home/user/myscript.sh' -
桌面自动启动(.desktop):不走 shell 初始化,PATH 常被重置为最小集。必须在 .desktop 文件中声明:
[Desktop Entry]
Exec=/bin/bash -c "export PATH=/usr/local/bin:$PATH; /home/user/myscript.sh"
Terminal=false
三、避免硬编码,用可靠方式补全 PATH
与其反复改 PATH 字符串,不如让脚本自己“找路”:
- 用
which python3或command -v pip替代固定路径,失败时再 fallback; - Python 脚本开头加判断:
import sys
if "/home/user/.local/lib/python3.x/site-packages" not in sys.path:
sys.path.insert(0, "/home/user/.local/lib/python3.x/site-packages") - 激活 conda/virtualenv 时,不用
source activate(bash-only),改用:
/home/user/miniconda3/bin/conda run -n myenv python script.py
四、验证是否真解决了
改完别急着重启,先模拟启动环境测试:
- systemd 场景:
sudo -u user env -i PATH=/usr/bin:/bin HOME=/home/user /bin/bash -c 'echo $PATH; python3 --version' - cron 场景:
env -i SHELL=/bin/sh PATH=/usr/bin:/bin /bin/sh -c 'your_script.sh'
只有在这些模拟环境下能跑通,开机才真正稳。











