systemctl start xxx 报 Job for xxx.service failed,真正的信息藏在三行输出里:Process exited with code、status= 和最后的 hint。会读这三行,绝大多数启动失败能在一分钟内定位。
先拿完整日志
journalctl -u xxx.service -n 80 --no-pager
只加 -n 80 而不是全文,是因为服务通常写在启动阶段就失败了,末尾反而最有信息。如果日志是空的,说明服务根本没跑到写日志那一步,问题在单元定义层。
按退出码分流
status=203/EXEC:执行文件找不到或没有执行权限。检查ExecStart指向的路径是否存在、文件是否有x位、脚本首行 shebang 的解释器是否存在。Python 脚本用/usr/bin/python3而非python3,PATH 在 systemd 环境下比 shell 里窄得多。status=1/FAILURE:程序自己退出。看journalctl里最后几行业务输出,通常是配置语法错、端口被占、工作目录不对。status=200/CHDIR:WorkingDirectory不存在或无权访问。status=217/USER:User=指定的账号不存在。status=226/NAMESPACE:ProtectSystem之类的加固选项把服务需要的路径给屏蔽了。
容易被忽略的三点
第一,ExecStart 里不要写 shell 语法,|、&&、重定向都无效。需要的话包一层 /bin/sh -c '...'。
第二,环境变量和交互式 shell 不共享。PATH、HOME 都可能不同,脚本里依赖相对命令时要显式写绝对路径,或者用 Environment= 声明。
第三,Type=forking 的服务,如果程序不是真的 fork 到后台,systemd 会一直等到超时然后判失败。大多数现代程序应该用 Type=simple。
把排查固化成一次操作
systemctl status xxx -l --no-pager; journalctl -u xxx -n 50 --no-pager; systemd-analyze verify /etc/systemd/system/xxx.service
第三条能提前发现单元文件里的语法和依赖错误,比反复重启试错快得多。
本文首发于 izzsj.com,作者保留全部权利。未经书面授权,禁止任何形式采集、转载与镜像;转载请注明来源并保留原文链接。
相关阅读
- 使用IMG2KVM快捷为Proxmox导入IMG镜像img2kvm是一个在PVE下导入IMG文件到虚拟机的工具,可以将img文件(含gz的压缩格
- 最新WIN10镜像下载.文件名 cn_windows_10_business_edition
- fail2ban 防暴力破解实战:让扫描器无处下手
- VPS 怎么选?国内外主机、线路与配置全解析(2025版)




还没有评论,来说两句吧...