Linux 与服务器运维 / 系统课时
依赖服务没启动该怎么查
依赖服务没启动该怎么查
一个服务本身的配置可能完全正确,却因为数据库、网络、消息队列或其他基础 Unit 没准备好而启动失败。排查这类问题时,关键不是反复重启当前服务,而是先还原 systemd 的依赖和启动顺序,再沿着失败的依赖 Unit 继续查状态与日志。
学习目标
- 用
list-dependencies和systemctl show看清 Unit 的依赖与排序关系 - 判断
Requires=、Wants=、After=分别说明什么 - 沿依赖链定位真正失败的基础服务,并完成复验
先看当前服务依赖了谁
假设业务服务名为 demo-api.service。先列出它的依赖树,再读取最关键的依赖属性。这里查看的是 systemd 已加载的 Unit 关系,不等同于应用代码中的所有外部依赖。
systemctl list-dependencies demo-api.service --all
systemctl show demo-api.service -p Requires -p Wants -p After预期输出(实际 Unit 名称和依赖集合由服务定义及系统环境决定):
demo-api.service
● ├─postgresql.service
● ├─network-online.target
● └─system.slice
Requires=postgresql.service
Wants=network-online.target
After=network-online.target postgresql.serviceRequires= 表示强依赖:启动当前 Unit 时会一并拉起所列 Unit;如果再配合 After=,被要求的 Unit 启动失败时,当前 Unit 不会按正常依赖链继续启动。Wants= 是较弱依赖,被依赖 Unit 失败不一定阻止当前 Unit 激活。After= 只定义启动或停止顺序,不代表“健康检查通过”,也不会单独创建依赖关系。

沿失败 Unit 继续查状态和日志
如果依赖树里已经看到数据库、网络或其他基础服务,就逐个确认它们是否处于 active。不要只看业务服务的日志,因为它可能只记录“连接失败”,真正根因在依赖服务自己的 journal 中。
sudo systemctl status postgresql.service --no-pager -l
sudo journalctl -u postgresql.service -b -n 50 --no-pager预期输出(只展示依赖 Unit 启动失败时应关注的通用状态,具体错误以现场日志为准):
● postgresql.service - <DESCRIPTION>
Active: failed (Result: exit-code)
postgresql.service: Failed with result 'exit-code'.看到依赖 Unit 为 failed 后,就应把它当成新的排障对象:检查它自己的配置、端口、权限、磁盘和日志,而不是继续修改 demo-api.service。如果数据库 Unit 实际名不是 postgresql.service,应使用前一步依赖列表中的真实名称。
别把已启动误当成已就绪
某些依赖即使 Unit 已经进入 active,应用仍可能暂时不可用。例如数据库进程已启动但还在恢复数据,网络接口已经配置但 DNS 或默认路由尚未可用。systemd 的依赖和排序只能描述 Unit 激活关系,不能替代应用层就绪检测。
对于网络类依赖,network.target 主要表示网络管理相关组件已经启动,并不保证网络已经可用;需要等待已配置网络时,通常应围绕 network-online.target 和系统对应的 wait-online 服务设计启动顺序。对于数据库或消息队列,则更适合让应用自身具备连接重试和退避机制,而不是把所有可用性判断都寄托在 Unit 顺序上。
修复后从依赖到业务服务逐层复验
修复基础服务后,先确认依赖 Unit 已恢复,再重启业务服务。这样能把“依赖仍失败”和“业务服务自身仍有问题”区分开。
sudo systemctl restart postgresql.service
systemctl is-active postgresql.service
sudo systemctl restart demo-api.service
systemctl is-active demo-api.service预期输出(依赖和业务服务都恢复时):
active
active如果依赖服务已经是 active,但业务服务仍失败,就重新查看 demo-api.service 的 journal。此时故障范围已经从“依赖没启动”缩小到业务服务自身配置、凭据、连接参数或应用级就绪问题,排查方向会清晰得多。