Linux 与服务器运维 / 系统课时

手工能运行为什么服务启动失败

手工能运行为什么服务启动失败

同一条程序命令在终端里能成功,交给 systemd 却报“命令不存在”“配置缺失”或连接失败,常见原因不是程序突然坏了,而是启动环境换了。本篇用一个最小服务复现差异,并给出从可执行文件、PATH 到环境变量的定位顺序。

学习目标

  • 解释登录 Shell 与 systemd 服务进程为何拥有不同环境
  • 用绝对路径、systemctl show 和日志定位环境差异
  • 判断应该在服务单元中显式配置什么,而不是依赖个人 Shell

先看懂两套启动环境

你在终端里执行程序时,进程通常继承当前 Shell 的环境。这个环境可能来自登录流程以及 .profile、.bash_profile、.bashrc 等文件,还可能包含你临时执行过的 export。

systemd 启动系统服务时,服务进程由 systemd 管理器创建,并不会先启动你的交互式 Shell,也不会自动读取个人 Shell 配置。因此,终端中的 PATH、语言设置、代理变量和应用变量都不能默认认为服务也能看到。

交互式 Shell 与 systemd 服务的环境来源对比

这里最重要的判断是:手工启动成功只能证明程序在当前 Shell 环境中可运行,不能证明 unit 文件已经描述了完整运行条件。

复现环境变量差异

先创建一个只打印环境信息的脚本。示例需要 root 权限写入 /usr/local/bin 和 /etc/systemd/system。

bash
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

预期输出

text
PATH=<PATH>
MY_APP_TOKEN=dev-token

实际 PATH 会因登录环境而不同。接着让 systemd 启动同一个脚本:

bash
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

预期输出

text
PATH=<PATH>
MY_APP_TOKEN=<unset>

具体 PATH 会因发行版和 systemd 构建配置而不同,但 MY_APP_TOKEN 不会因为你在当前终端执行过 export 就自动进入这个系统服务。

按固定顺序定位启动失败

先检查 ExecStart 是否依赖 Shell 查找。systemd 不会把 ExecStart 当作你在终端输入的一整行 Shell 命令处理,因此不要依赖别名、Shell 函数,也不要假设个人 PATH 一定存在。对关键可执行文件使用绝对路径最容易排除歧义。

再查看 unit 实际生效的启动命令和环境:

bash
systemctl show env-demo.service -p ExecStart -p Environment

预期输出

text
ExecStart={ path=/usr/local/bin/env-demo.sh ; argv[]=/usr/local/bin/env-demo.sh ; ... }
Environment=

不同 systemd 版本对 ExecStart 的格式化细节可能不同;这里要确认的是实际执行路径,以及 Environment 是否包含应用所需变量。

最后查看服务日志,而不是只盯着 systemctl start 的退出状态:

bash
sudo journalctl -u env-demo.service -b --no-pager

预期结果

text
日志中应包含本次启动的服务记录,以及脚本输出的 PATH 和 MY_APP_TOKEN=<unset>。

如果应用报告“找不到命令”“缺少配置”“无法解析代理”等信息,就把报错中的依赖逐项与 unit 的运行环境核对。

不要用个人 Shell 修补系统服务

把变量写进 ~/.bashrc、给自己加 alias,或者在终端里先 export 再重启服务,都不能稳定修复系统服务。服务需要的运行条件应由 unit、Environment=、EnvironmentFile=、专用配置文件或 systemd 的凭据机制明确提供。

如果某个程序只有在 bash -lc 下才成功,应该先找出它究竟依赖了哪段 Shell 初始化,而不是把“启动一个登录 Shell”当作长期方案。把依赖显式化后,服务在开机启动、无人登录和故障恢复时才能得到一致结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

手工能运行为什么服务启动失败

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通