Linux 与服务器运维 / 系统课时
服务启动失败应该先查哪里
服务启动失败应该先查哪里
服务启动失败时,最有效的做法不是立刻修改配置,而是先建立证据链:确认 systemd 看到的失败状态,再看主进程退出信息和本次启动日志,最后检查路径、权限、配置与依赖。按固定顺序排查,可以避免被次要报错带偏。
学习目标
- 使用
systemctl status、退出状态和journalctl建立服务失败的排查顺序 - 根据日志特征区分路径、权限、配置和依赖问题
- 修复后重新启动服务并验证最终状态
先确认 systemd 记录了什么
收到“服务起不来”的告警后,先不要直接编辑配置文件。第一条命令通常是 systemctl status,它会同时给出单元文件是否加载、当前状态、主进程退出结果以及最近几条日志。
下面脚本接收一个服务名,并依次收集状态、退出结果、启动日志和实际单元配置。例如保存为 diagnose-service.sh,再执行 bash diagnose-service.sh nginx.service。实际服务名以当前主机为准。
#!/usr/bin/env bash
set -u
SERVICE="${1:?usage: diagnose-service.sh SERVICE}"
echo '=== status ==='
systemctl status "$SERVICE" --no-pager -l || true
echo '=== exit result ==='
systemctl show "$SERVICE" -p Result -p ExecMainCode -p ExecMainStatus
echo '=== journal ==='
journalctl -u "$SERVICE" -b -n 50 --no-pager
echo '=== unit definition ==='
systemctl cat "$SERVICE"预期输出
=== status ===
● <SERVICE> - <DESCRIPTION>
Loaded: loaded (<PATH>; <STATE>; preset: <STATE>)
Active: failed (Result: <RESULT>) since <TIME>
...
=== exit result ===
Result=<RESULT>
ExecMainCode=<ID>
ExecMainStatus=<ID>
=== journal ===
<TIME> <HOST> systemd[1]: ...
...
=== unit definition ===
# <PATH>
[Unit]
...<TIME>、<HOST>、<PATH> 和 <ID> 都会因主机与故障类型而变化。这里关注的不是逐字匹配输出,而是先判断失败发生在 systemd 启动进程之前,还是程序已经启动后自行退出。

用退出信息缩小范围
Active: failed 只说明最终结果,真正有价值的是旁边的失败原因。若状态中出现类似 status=203/EXEC,通常表示 systemd 无法执行 ExecStart 指定的程序,例如路径不存在、文件不可执行或脚本解释器不存在。此时应先检查单元文件中的命令,而不是怀疑应用内部配置。
如果程序已经被成功执行,但 ExecMainStatus 是应用返回的非零退出码,则应继续查看该程序自己的错误信息。退出码的含义由程序定义,不能仅凭数字猜测原因。
按日志特征检查常见根因
路径问题常见于 ExecStart 写错、部署文件被移动,或脚本首行解释器路径不存在。先通过 systemctl cat 确认 systemd 实际加载的配置,再检查目标路径是否存在以及是否具有执行权限。
权限问题除了普通文件权限,还可能来自单元中的 User=、Group=、工作目录权限或安全机制。日志若出现 Permission denied,应结合服务实际运行用户检查目标文件和目录;不要直接用 chmod 777 掩盖权限设计错误。
配置错误通常发生在程序已经开始执行之后。Web 服务、数据库等软件往往提供独立的配置检查命令,应优先使用程序自己的校验工具;journal 中的语法错误、未知指令、端口冲突等信息通常比 systemd 的最终退出码更具体。
依赖问题则常出现 Dependency failed、挂载点不可用或依赖单元失败。需要注意,单独的 After= 只控制启动顺序,并不表示目标单元必须成功;真正的依赖关系还要结合 Requires=、Wants= 等设置判断。
修复后验证而不是只看 restart
修复问题后执行重启,并分别检查命令返回结果与最终活动状态。下面的 <SERVICE> 是说明性占位符,执行前应替换成真实单元名。
sudo systemctl restart <SERVICE>
systemctl is-active <SERVICE>
systemctl status <SERVICE> --no-pager -l预期输出
active
● <SERVICE> - <DESCRIPTION>
Loaded: loaded (<PATH>; <STATE>; preset: <STATE>)
Active: active (running) since <TIME>
...只有 restart 命令没有报错还不够,最终应确认服务处于 active,并根据业务需要继续验证端口、进程或应用接口。排查的核心顺序可以固定为:先看状态,再读退出信息和 journal,依据证据检查路径、权限、配置与依赖,最后重新启动并验证。