Linux 与服务器运维 / 系统课时
手工能启动为何 systemd 不行
手工能启动为何 systemd 不行
同一条程序命令在终端里运行正常,交给 systemd 却报“命令不存在”、找不到配置或缺少环境变量,通常不是程序突然坏了,而是两种启动方式拥有不同的运行上下文。本节用可验证的顺序拆开 PATH、环境变量和工作目录,定位配置差异。
学习目标
- 区分交互式 Shell 与 systemd 服务的运行环境来源
- 用
systemctl show、systemctl cat和绝对路径验证关键差异 - 把依赖隐式 Shell 环境的启动方式改成可重复的 unit 配置
先区分两种运行上下文
手工启动时,程序通常继承当前终端的环境。~/.bashrc、~/.profile 或其他 Shell 初始化文件可能已经把自定义目录加入 PATH,导出了变量,并且你正好站在项目目录里。
systemd 系统服务则由服务管理器直接创建进程。它不会因为你能在登录 Shell 中执行某条命令,就自动继承该 Shell 的变量、别名、当前目录或初始化脚本。排查时应把“命令本身是否正确”和“服务运行上下文是否完整”分开验证。
| 项目 | 交互式 Shell | systemd 系统服务 |
|---|---|---|
PATH |
常被 Shell 配置扩展 | 不应依赖个人 Shell 配置 |
| 环境变量 | 可来自 profile、终端或手工 export |
主要由 unit、manager 环境等提供 |
| 当前目录 | 你执行命令时所在目录 | 未配置时不要假设是项目目录 |
| Shell 语法 | 由 Shell 解释 | ExecStart= 默认不经过交互式 Shell |
用 unit 明确服务需要什么
假设应用位于 /opt/myapp,由 app 用户运行,需要 APP_ENV=production。不要依赖登录用户已经设置好的目录和变量,可以把关键上下文直接写进 unit。
[Unit]
Description=My App
[Service]
Type=simple
User=app
WorkingDirectory=/opt/myapp
Environment="APP_ENV=production"
ExecStart=/usr/bin/python3 /opt/myapp/app.py
Restart=on-failure
[Install]
WantedBy=multi-user.target这是配置文件示例,不产生控制台输出。保存为 /etc/systemd/system/myapp.service 后,WorkingDirectory= 决定相对路径的基准,Environment= 提供应用变量,ExecStart= 使用绝对路径避免依赖交互式 PATH。如果变量较多,可以改用 EnvironmentFile=,但文件内容仍应由服务配置显式管理。
按顺序验证 PATH、变量和目录
先让 systemd 重新读取 unit,再查看它实际解析出的关键属性。不要只盯着你编辑的文件,因为 drop-in 覆盖项可能改变最终配置。
sudo systemctl daemon-reload
sudo systemctl restart myapp.service
systemctl show myapp.service -p User -p WorkingDirectory -p Environment
systemctl is-active myapp.service预期输出
User=app
WorkingDirectory=/opt/myapp
Environment=APP_ENV=production
active如果最后不是 active,继续看 unit 的最终内容和本次启动日志。
systemctl cat myapp.service
journalctl -u myapp.service -b -n 50 --no-pager预期结果
<UNIT_CONTENT>
<SERVICE_LOGS>第一条应列出主 unit 以及已加载的 drop-in,第二条应给出本次启动的最近 50 条服务日志;实际内容取决于机器和故障。重点是确认失败发生在可执行文件定位、应用自身启动,还是读取相对路径或环境变量之后。
用症状反推是哪一项不同
出现 No such file or directory 时,先确认 ExecStart= 指向的解释器或二进制是否真的存在,再检查脚本内部引用的相对路径。手工启动依赖 cd /opt/myapp 才成功,通常意味着应配置 WorkingDirectory= 或把文件路径改成绝对路径。
程序提示缺少 JAVA_HOME、数据库地址或运行模式时,比较当前 Shell 的变量与 unit 中显式配置的变量。不要把 export ... 只写进某个管理员账号的 profile 后期待系统服务自动读取。
只有手工输入 mytool 能找到命令,而服务找不到时,用 command -v mytool 找到真实路径,并在 ExecStart= 或应用配置中使用绝对路径。应用启动后再调用子进程时,也要为它提供明确的 PATH,因为子进程继承的是服务环境而不是你的终端环境。
不要用 Shell 包装掩盖配置问题
把失败命令简单改成 /bin/bash -lc '...' 有时会“恢复正常”,但这也可能把个人 profile、路径修改和隐式副作用一起带进服务,导致部署不可重复。更稳妥的做法是逐项明确 User=、WorkingDirectory=、Environment=、EnvironmentFile= 和绝对的 ExecStart=。
当手工启动成功而 systemd 失败时,先比较运行身份、工作目录、环境变量和可执行文件路径,再看应用日志。把这些差异显式写入 unit 后,服务才能在重启、无人登录或换机器时保持同样的启动结果。