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。

ini
[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 覆盖项可能改变最终配置。

bash
sudo systemctl daemon-reload
sudo systemctl restart myapp.service
systemctl show myapp.service -p User -p WorkingDirectory -p Environment
systemctl is-active myapp.service

预期输出

text
User=app
WorkingDirectory=/opt/myapp
Environment=APP_ENV=production
active

如果最后不是 active,继续看 unit 的最终内容和本次启动日志。

bash
systemctl cat myapp.service
journalctl -u myapp.service -b -n 50 --no-pager

预期结果

text
<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 后,服务才能在重启、无人登录或换机器时保持同样的启动结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

手工能启动为何 systemd 不行

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

登录哪都通