systemd 单元文件里最容易写错的五处
写了几十个单元文件之后,踩过的坑会沉淀成几个固定动作。这里记下五处最常出错的写法,都是我自己或同事实际踩到的。
一、User= 和文件权限互相打架
把服务降权运行是对的,但配置文件的权限常常忘了跟着改。典型症状是启动瞬间就退出,journal 里一行:
Failed to start: open /usr/local/etc/svc/config.json: permission denied
单元里写着 User=svc,配置文件却是 root:root 600,进程当然读不到。修法是把配置目录整棵 chown 给运行用户,目录 750,文件 600。
顺带一提,目录权限也要给:只改文件不改目录,进程能打开已有文件却建不了锁文件和日志。
二、退出码要区分「配置错」和「跑挂了」
配置写错的时候不该无限重启,那样只会把 journal 刷满。用 RestartPreventExitStatus 把「配置错误」这个退出码摘出来:
Restart=on-failure
RestartSec=3
RestartPreventExitStatus=23
程序在解析配置失败时 exit 23,systemd 就不再拉它,留下一条干净的失败状态。
三、After= 保证顺序,不保证可用
After=nginx.service 只说明启动顺序,不说明 nginx 已经在监听。反代型服务经常在 nginx 还没 bind 完的时候就去连,拿到 connection refused 然后退出。
稳妥做法是在 ExecStartPre 里做一次探活循环,或者在程序里对首个连接做重试。启动脚本里 sleep 两秒这种写法,重启快的时候靠得住,慢的时候就翻车。
四、PrivateTmp 会换掉 /tmp
单元里开了 PrivateTmp=yes,进程看到的 /tmp 是一个私有挂载点。如果程序把 socket 放在 /tmp 等别的进程来连,对方是找不到的。
要么改成 /run/svc/ 这类正规位置,要么就关掉 PrivateTmp。别在两者之间猜。
五、日志限速会吃掉排障信息
journald 默认对同一服务有速率限制,短时间刷几千行就会丢,日志里留一句 Suppressed N messages。
排障期间在单元里加:
LogRateLimitIntervalSec=0
LogRateLimitBurst=0
或者临时 journalctl -u svc -f 并接受丢行,但后者遇到崩溃循环就没用了。
写完单元文件跑一遍 systemd-analyze verify,至少能挡住路径写错和指令拼错这两类。