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

排查服务启动失败

排查服务启动失败

服务启动失败时,最有效的顺序是先拿到 systemd 的失败原因,再验证配置、端口、权限和依赖。这样可以避免反复重启掩盖日志,也能把“服务本身错误”和“外部资源冲突”快速分开。

学习目标

  • 用 systemctl 和 journalctl 获取启动失败的第一手证据
  • 按配置、端口、权限和依赖顺序定位常见根因
  • 修复后验证服务状态、监听端口和失败日志是否恢复正常

先读取状态和本次启动日志

下面以 nginx 为例,实际排查时替换为目标 unit。先看状态,再看本次开机后的最近日志;不要连续执行 restart,否则最早的报错可能被后续信息淹没。

bash
SERVICE=nginx
systemctl status "$SERVICE" --no-pager -l
journalctl -u "$SERVICE" -b -n 50 --no-pager

预期输出

text
● nginx.service - <DESCRIPTION>
     Loaded: loaded (<PATH>; enabled; preset: <VALUE>)
     Active: failed (Result: exit-code) since <TIME>
...
<TIME> <HOST> nginx[<PID>]: <ERROR MESSAGE>

实际 unit 描述、路径、时间和 PID 会不同。优先记录最早出现的明确错误,例如配置语法错误、Address already in use、Permission denied 或依赖单元失败。

先验证配置文件,不要靠重启试错

很多服务都提供独立的配置校验命令。以 Nginx 为例,nginx -t 可以在不真正启动服务的情况下检查语法和引用文件。

bash
sudo nginx -t

预期结果

text
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

如果这里失败,先修复报错行再启动服务。其他软件应使用自己的配置检查器,例如 sshd -t、named-checkconf 或应用自带的 --check、configtest 子命令。

检查目标端口是否已被占用

日志出现 Address already in use 时,不要直接杀进程。先确认谁占用了端口、它是否是应该存在的旧实例,以及两个服务是否本来就配置了同一个监听地址。

bash
sudo ss -ltnp '( sport = :80 )'

预期输出

text
State  Recv-Q Send-Q Local Address:Port Peer Address:Port Process
LISTEN 0      <VALUE> 0.0.0.0:80      0.0.0.0:*       users:(("<PROC>",pid=<PID>,fd=<FD>))

如果占用者就是同一服务的残留进程,先确认 systemd 状态和进程归属;如果是另一个服务,应修改监听端口或停用冲突服务,而不是用 kill -9 作为默认处理方式。

核对运行用户、文件权限和依赖

Permission denied 常见于配置文件、证书、PID 目录、日志目录或 Unix Socket。先查看 unit 实际使用的启动命令和运行身份,再逐级检查路径权限。

bash
systemctl show nginx -p User -p Group -p ExecStart
namei -l /etc/nginx/nginx.conf
systemctl list-dependencies --failed nginx

预期输出

text
User=
Group=
ExecStart={<PATH> ...}
f: /etc/nginx/nginx.conf
drwxr-xr-x root root /
drwxr-xr-x root root etc
drwxr-xr-x root root nginx
-rw-r--r-- root root nginx.conf
nginx.service

User= 为空并不表示“没有用户”,而是 unit 未显式指定 User=,通常由进程自身决定权限模型。若依赖列表出现失败单元,应先修复依赖;若路径某一级缺少执行权限,服务即使能读目标文件名,也无法穿过该目录。

修复后启动并验证三件事

完成配置、端口、权限或依赖修复后,再启动服务。验证时同时看 systemd 状态、实际监听端口和最近错误日志,避免只看到 active 就认为业务一定可用。

bash
sudo systemctl restart nginx
systemctl is-active nginx
sudo ss -ltnp '( sport = :80 )'
journalctl -u nginx -b -n 20 --no-pager

预期输出

text
active
State  Recv-Q Send-Q Local Address:Port Peer Address:Port Process
LISTEN 0      <VALUE> 0.0.0.0:80      0.0.0.0:*       users:(("nginx",pid=<PID>,fd=<FD>))
...
<TIME> <HOST> systemd[1]: Started nginx.service - <DESCRIPTION>.

实际端口、PID 和日志文本可能不同。若服务仍失败,就回到最新一轮 journalctl 的第一条明确错误继续排查;不要同时改配置、权限和端口多个变量,否则很难判断究竟是哪项修复生效。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查服务启动失败

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

登录哪都通