Linux 与服务器运维 / 系统课时
排查服务启动失败
排查服务启动失败
服务启动失败时,最有效的顺序是先拿到 systemd 的失败原因,再验证配置、端口、权限和依赖。这样可以避免反复重启掩盖日志,也能把“服务本身错误”和“外部资源冲突”快速分开。
学习目标
- 用
systemctl和journalctl获取启动失败的第一手证据 - 按配置、端口、权限和依赖顺序定位常见根因
- 修复后验证服务状态、监听端口和失败日志是否恢复正常
先读取状态和本次启动日志
下面以 nginx 为例,实际排查时替换为目标 unit。先看状态,再看本次开机后的最近日志;不要连续执行 restart,否则最早的报错可能被后续信息淹没。
SERVICE=nginx
systemctl status "$SERVICE" --no-pager -l
journalctl -u "$SERVICE" -b -n 50 --no-pager预期输出
● 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 可以在不真正启动服务的情况下检查语法和引用文件。
sudo nginx -t预期结果
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 时,不要直接杀进程。先确认谁占用了端口、它是否是应该存在的旧实例,以及两个服务是否本来就配置了同一个监听地址。
sudo ss -ltnp '( sport = :80 )'预期输出
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 实际使用的启动命令和运行身份,再逐级检查路径权限。
systemctl show nginx -p User -p Group -p ExecStart
namei -l /etc/nginx/nginx.conf
systemctl list-dependencies --failed nginx预期输出
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.serviceUser= 为空并不表示“没有用户”,而是 unit 未显式指定 User=,通常由进程自身决定权限模型。若依赖列表出现失败单元,应先修复依赖;若路径某一级缺少执行权限,服务即使能读目标文件名,也无法穿过该目录。
修复后启动并验证三件事
完成配置、端口、权限或依赖修复后,再启动服务。验证时同时看 systemd 状态、实际监听端口和最近错误日志,避免只看到 active 就认为业务一定可用。
sudo systemctl restart nginx
systemctl is-active nginx
sudo ss -ltnp '( sport = :80 )'
journalctl -u nginx -b -n 20 --no-pager预期输出
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 的第一条明确错误继续排查;不要同时改配置、权限和端口多个变量,否则很难判断究竟是哪项修复生效。