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

排查 systemd 服务启动失败

排查 systemd 服务启动失败

systemd 服务启动失败时,最有效的方法不是反复执行 restart,而是把“状态、退出码、日志、启动命令、运行用户”串成一条证据链。本文给出一套可复用的排查顺序,帮助你从表面现象定位到真正失败点。

学习目标

  • 能从 systemctl status 和 journal 中提取关键失败信息
  • 能核对 ExecStart、运行用户和工作目录等启动条件
  • 能在修复后通过 systemd 状态与日志确认服务恢复

先从状态和退出码缩小范围

假设待排查的单元为 <UNIT>,先读取当前状态,不要急着修改配置:

bash
systemctl status <UNIT> --no-pager
systemctl show <UNIT> -p ActiveState -p SubState -p ExecMainStatus

预期输出:

text
● <UNIT> - <DESCRIPTION>
   Loaded: loaded (...)
   Active: failed (...)
   ...
ActiveState=failed
SubState=failed
ExecMainStatus=<EXIT_CODE>

实际时间、PID、描述和退出码会不同。这里先确认三件事:单元是否成功加载、主进程是否真的启动过、退出码是否指向应用自身失败。若 Loaded 阶段就异常,应优先检查单元文件;若主进程已执行后退出,则继续看 journal。

用 journal 找到最接近根因的错误

查看当前启动周期内该服务的最近日志:

bash
journalctl -u <UNIT> -b -n 50 --no-pager

预期输出:

text
<TIME> <HOST> systemd[1]: Starting <UNIT>...
<TIME> <HOST> <PROCESS>[<ID>]: <ERROR_MESSAGE>
<TIME> <HOST> systemd[1]: <UNIT>: Main process exited, code=exited, status=<EXIT_CODE>
<TIME> <HOST> systemd[1]: <UNIT>: Failed with result 'exit-code'.

<TIME>、<HOST>、<ID>、<EXIT_CODE> 和应用错误内容都是动态值。排查时优先关注主进程在退出前打印的第一条明确错误,而不是只盯着最后一行 Failed with result。

systemd 服务启动失败排查链路

核对 systemd 实际执行了什么

服务文件中的 ExecStart、User、Group、WorkingDirectory 和 EnvironmentFile 都可能让命令在交互式终端可运行、在 systemd 下却失败。先读取 systemd 当前实际加载的配置:

bash
systemctl cat <UNIT>
systemctl show <UNIT> -p User -p Group -p WorkingDirectory -p FragmentPath

预期输出:

text
# <UNIT_FILE_PATH>
[Service]
ExecStart=<COMMAND>
User=<USER>
...
User=<USER>
Group=<GROUP>
WorkingDirectory=<PATH>
FragmentPath=<UNIT_FILE_PATH>

不要只看你以为生效的文件。systemctl cat 能同时显示主单元文件和 drop-in 覆盖项,而 systemctl show 则反映 systemd 解析后的关键属性。若 ExecStart 使用相对路径、运行用户无权访问可执行文件,或工作目录不存在,服务都可能立即失败。

修复后重新加载并验证

如果修改了单元文件或 drop-in,先让 systemd 重新读取配置,再启动服务并确认状态:

bash
sudo systemctl daemon-reload
sudo systemctl restart <UNIT>
systemctl is-active <UNIT>
systemctl status <UNIT> --no-pager

预期输出:

text
active
● <UNIT> - <DESCRIPTION>
   Loaded: loaded (...)
   Active: active (running) since <TIME>; ...

若只是修改应用自己的配置文件,而没有改 systemd 单元定义,通常不需要 daemon-reload。daemon-reload 的作用是重新读取 unit 配置,不会替代应用自身的配置重载逻辑。

可靠的 systemd 排障顺序可以概括为:先看状态确定失败阶段,再读 journal 找应用级错误,然后核对 systemd 的实际启动上下文,最后只修改已被证据指向的问题并重新验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查 systemd 服务启动失败

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

登录哪都通