Linux 与服务器运维 / 系统课时
服务启动失败先看 status 什么
服务启动失败先看 status 什么
systemctl status 是排查 systemd 服务启动失败的第一屏信息。正确的阅读顺序是先看单元是否加载成功,再看当前状态和失败结果,随后核对主进程、退出码与最近日志,从而快速判断下一步该查配置、可执行文件还是应用自身错误。
学习目标
- 从
systemctl status中识别加载状态、运行状态和失败结果 - 根据 PID、退出码和信号判断失败类型
- 知道何时继续查看 journal 日志并验证修复
先完整查看 status
排障时建议关闭分页并保留长行,避免关键的 ExecStart、退出码或错误消息被截断。下面的 <SERVICE> 要替换为真实单元名,例如 nginx.service。
UNIT="<SERVICE>"
systemctl status "$UNIT" --no-pager -l预期输出
● <SERVICE> - <DESCRIPTION>
Loaded: loaded (<PATH>; enabled; preset: enabled)
Active: failed (Result: exit-code) since <TIME>
Process: <ID> ExecStart=<PATH> (code=exited, status=1/FAILURE)
Main PID: <ID> (code=exited, status=1/FAILURE)实际路径、时间、PID 和描述会不同。Loaded 说明 systemd 是否成功找到并解析单元文件;它显示 loaded 并不代表服务已经运行。真正决定当前状态的是 Active,而括号中的 Result 会告诉你 systemd 最终把这次启动归类为什么失败。
按字段判断失败发生在哪一层
阅读 status 时可以按“加载 → 状态 → 进程 → 日志”的顺序定位。
Loaded: loaded:单元文件已经加载;若出现not-found或加载错误,先检查单元名、文件路径和语法。Active: failed:启动过程已经失败;activating则表示仍卡在启动阶段,需关注超时、ExecStartPre或依赖项。Process与Main PID:指出实际执行过的进程和结果。PID 已退出很正常,关键是后面的code与status。Result: exit-code:程序主动以非零状态退出;若是signal、timeout等结果,则应转向信号、超时或外部终止原因。- 底部最近日志:适合快速看最后几条错误,但它只是一小段历史,信息不足时应继续查 journal。
用退出码缩小根因
普通的 status=1/FAILURE 只说明应用返回了非零退出码,真正原因通常在应用日志或配置检查结果中。systemd 自身的一些状态码则能更直接指向启动阶段问题。
| status 表现 | 常见含义 | 优先检查 |
|---|---|---|
status=1/FAILURE |
应用主动失败退出 | 应用配置、参数、依赖与日志 |
status=203/EXEC |
systemd 无法执行 ExecStart |
路径、执行权限、解释器、挂载属性 |
code=killed |
进程被信号终止 | 信号来源、超时、OOM、人工终止 |
Result=timeout |
启动或停止超过限制 | TimeoutStartSec、外部依赖、阻塞点 |
尤其不要把 203/EXEC 当成“应用内部报错”:这种情况下应用往往根本没有成功启动,继续翻应用业务日志通常得不到答案。
status 不够时继续看 journal
systemctl status 只带最近少量日志。需要完整上下文时,直接查询当前启动周期内该单元的 journal 记录。
UNIT="<SERVICE>"
journalctl -u "$UNIT" -b -n 50 --no-pager预期输出
<TIME> <HOST> systemd[1]: Starting <SERVICE>...
<TIME> <HOST> <PROCESS>[<ID>]: <ERROR_MESSAGE>
<TIME> <HOST> systemd[1]: <SERVICE>: Failed with result 'exit-code'.实际日志格式和内容会不同。若 status 已经明确给出 203/EXEC,先检查 ExecStart 指向的文件是否存在并可执行;若只是普通退出码,则重点阅读应用在失败前输出的第一条具体错误,而不是只盯最后一行“Failed”。
修复后验证状态是否真正恢复
修改单元文件后先执行 daemon-reload,再重启服务并重新读取状态。若只改了应用自己的配置文件,通常不需要 daemon-reload,但仍要重启或重载对应服务。
UNIT="<SERVICE>"
sudo systemctl daemon-reload
sudo systemctl restart "$UNIT"
systemctl status "$UNIT" --no-pager -l预期输出
● <SERVICE> - <DESCRIPTION>
Loaded: loaded (<PATH>; enabled; preset: enabled)
Active: active (running) since <TIME>
Main PID: <ID> (<PROCESS>)这份输出适用于长期运行服务,实际字段会随单元类型不同。最终判断不应只看 active (running):还要确认应用端口、健康检查或实际业务请求已经恢复,否则可能只是“进程活着”,服务功能仍不可用。