Linux 服务启动失败：把排查缩小到三个入口

服务报错时先不要反复重启。记录失败时间、最近变更和服务名，再分别检查进程、日志与监听端口。

第一步：看服务的最后状态

systemctl status SERVICE --no-pager -l
journalctl -u SERVICE --since "30 minutes ago" --no-pager

把 SERVICE 替换为实际服务名。注意退出代码、配置文件路径和失败前最后一条日志。日志可能含个人资料，分享前只保留与错误有关的部分并脱敏。

第二步：区分启动失败与无法访问

ss -lntp
df -h
df -i

进程存在但端口未监听，通常仍属于服务内部问题；端口只监听回环地址，需要检查原有反向代理入口。空间或 inode 耗尽也会导致服务无法写临时文件，不应直接删除未知业务目录。

第三步：一次只改一个变量

修改配置前保存副本，使用程序自带的配置检查命令。检查通过后执行 reload；程序不支持 reload 时再安排重启。修改后复查日志和业务请求，而不是只看进程变绿。

留下能复用的记录

记录版本、触发条件、错误原文、变更项和恢复方式。下一次相似故障先比对这些字段，避免重走所有排查步骤。