Linux 与服务器运维 / 系统课时
手工能运行为什么服务启动失败
手工能运行为什么服务启动失败
同一条程序命令在终端里能成功,交给 systemd 却报“命令不存在”“配置缺失”或连接失败,常见原因不是程序突然坏了,而是启动环境换了。本篇用一个最小服务复现差异,并给出从可执行文件、PATH 到环境变量的定位顺序。
学习目标
- 解释登录 Shell 与 systemd 服务进程为何拥有不同环境
- 用绝对路径、
systemctl show和日志定位环境差异 - 判断应该在服务单元中显式配置什么,而不是依赖个人 Shell
先看懂两套启动环境
你在终端里执行程序时,进程通常继承当前 Shell 的环境。这个环境可能来自登录流程以及 .profile、.bash_profile、.bashrc 等文件,还可能包含你临时执行过的 export。
systemd 启动系统服务时,服务进程由 systemd 管理器创建,并不会先启动你的交互式 Shell,也不会自动读取个人 Shell 配置。因此,终端中的 PATH、语言设置、代理变量和应用变量都不能默认认为服务也能看到。

这里最重要的判断是:手工启动成功只能证明程序在当前 Shell 环境中可运行,不能证明 unit 文件已经描述了完整运行条件。
复现环境变量差异
先创建一个只打印环境信息的脚本。示例需要 root 权限写入 /usr/local/bin 和 /etc/systemd/system。
sudo tee /usr/local/bin/env-demo.sh >/dev/null <<'EOF'
#!/bin/sh
printf 'PATH=%s\n' "$PATH"
printf 'MY_APP_TOKEN=%s\n' "${MY_APP_TOKEN:-<unset>}"
EOF
sudo chmod +x /usr/local/bin/env-demo.sh
export MY_APP_TOKEN=dev-token
/usr/local/bin/env-demo.sh预期输出
PATH=<PATH>
MY_APP_TOKEN=dev-token实际 PATH 会因登录环境而不同。接着让 systemd 启动同一个脚本:
sudo tee /etc/systemd/system/env-demo.service >/dev/null <<'EOF'
[Unit]
Description=Environment demo
[Service]
Type=oneshot
ExecStart=/usr/local/bin/env-demo.sh
EOF
sudo systemctl daemon-reload
sudo systemctl start env-demo.service
sudo journalctl -u env-demo.service -o cat --no-pager | tail -n 2预期输出
PATH=<PATH>
MY_APP_TOKEN=<unset>具体 PATH 会因发行版和 systemd 构建配置而不同,但 MY_APP_TOKEN 不会因为你在当前终端执行过 export 就自动进入这个系统服务。
按固定顺序定位启动失败
先检查 ExecStart 是否依赖 Shell 查找。systemd 不会把 ExecStart 当作你在终端输入的一整行 Shell 命令处理,因此不要依赖别名、Shell 函数,也不要假设个人 PATH 一定存在。对关键可执行文件使用绝对路径最容易排除歧义。
再查看 unit 实际生效的启动命令和环境:
systemctl show env-demo.service -p ExecStart -p Environment预期输出
ExecStart={ path=/usr/local/bin/env-demo.sh ; argv[]=/usr/local/bin/env-demo.sh ; ... }
Environment=不同 systemd 版本对 ExecStart 的格式化细节可能不同;这里要确认的是实际执行路径,以及 Environment 是否包含应用所需变量。
最后查看服务日志,而不是只盯着 systemctl start 的退出状态:
sudo journalctl -u env-demo.service -b --no-pager预期结果
日志中应包含本次启动的服务记录,以及脚本输出的 PATH 和 MY_APP_TOKEN=<unset>。如果应用报告“找不到命令”“缺少配置”“无法解析代理”等信息,就把报错中的依赖逐项与 unit 的运行环境核对。
不要用个人 Shell 修补系统服务
把变量写进 ~/.bashrc、给自己加 alias,或者在终端里先 export 再重启服务,都不能稳定修复系统服务。服务需要的运行条件应由 unit、Environment=、EnvironmentFile=、专用配置文件或 systemd 的凭据机制明确提供。
如果某个程序只有在 bash -lc 下才成功,应该先找出它究竟依赖了哪段 Shell 初始化,而不是把“启动一个登录 Shell”当作长期方案。把依赖显式化后,服务在开机启动、无人登录和故障恢复时才能得到一致结果。