systemd.exec WorkingDirectory 怎样固定服务工作目录

服务明明能启动，程序却把相对路径文件写到了意外位置，通常不是应用“随机切目录”，而是 unit 没有明确设置当前工作目录。对 systemd 服务，最小修复是在 [Service] 中加入 WorkingDirectory=/srv/report-api；路径必须真实存在，且运行用户要有相应的访问权限。

官方地址：https://www.freedesktop.org/software/systemd/man/latest/systemd.exec.html

WorkingDirectory 的最小写法和启动边界

把应用工作目录固定下来，推荐直接使用绝对路径。下面的 unit 只展示关键关系：systemd 先设置目录，再启动程序，程序内部的相对路径才有稳定含义。

[Unit]
Description=Report API service
After=network.target

[Service]
# 让进程以这个目录作为当前工作目录，路径必须已存在
WorkingDirectory=/srv/report-api
# 运行用户需要能访问工作目录及其父目录
User=report
# 相对路径配置、日志或模板都会从 WorkingDirectory 解析
ExecStart=/usr/local/bin/report-api --config=config/app.yaml

[Install]
WantedBy=multi-user.target

这里的 config/app.yaml 会从 /srv/report-api/config/app.yaml 解析。WorkingDirectory=不是 cd 命令，也不等于 RootDirectory=：前者只改变当前目录，后者才会改变进程看到的根目录，二者不要混用。

目录准备与服务重载

先准备目录并把权限边界说清楚，再让 systemd 读取新配置。生产环境不建议为了“先跑起来”直接把目录改成全局可写。

# 创建服务目录并把所有权交给运行用户
sudo install -d -o report -g report -m 0750 /srv/report-api
sudo install -d -o report -g report -m 0750 /srv/report-api/config

# 修改 unit 后让 systemd 重新读取文件，再重启服务
sudo systemctl daemon-reload
sudo systemctl restart report-api.service

# 先看状态，失败时再查本次启动日志
sudo systemctl status report-api.service --no-pager
sudo journalctl -u report-api.service -b --no-pager -n 80

如果日志提示 CHDIR、No such file or directory，先查路径是否存在；如果是 Permission denied，再查 User=report 对目录的执行和读取权限。不要先把问题归结为应用参数。

systemctl 如何确认真正生效

状态页能说明服务是否成功，但不能代替属性检查。用 systemctl show 读取 systemd 当前加载的值，特别适合排查 drop-in 覆盖、编辑错文件或忘记重载。

# 读取 systemd 当前采用的工作目录和运行用户
systemctl show report-api.service \
  --property=WorkingDirectory,User,ExecStart,FragmentPath,DropInPaths

# 查看 unit 的完整合并配置，确认没有被 drop-in 覆盖
systemctl cat report-api.service

权限、用户实例和挂载依赖的边界

官方定义中，路径相对于服务的 root directory 解析；没有设置 RootDirectory= 时就是主机根目录。系统实例未设置该项时默认工作目录是根目录，用户实例则使用对应用户的 home。写成 WorkingDirectory=~ 可以明确使用 User= 指定用户的 home。

目录可能来自单独的文件系统或网络挂载。设置 WorkingDirectory= 会让 unit 自动获得访问该路径所需挂载单元的依赖，但这不代表目录会被创建，也不代表应用一定拥有写权限。若目录暂时缺失且允许服务继续启动，可写成：

[Service]
# 目录不存在时不把缺失目录视为致命错误；应用仍需能处理相对路径失败
WorkingDirectory=-/var/lib/report-api

- 前缀适合有明确降级逻辑的程序，不适合掩盖部署遗漏。服务需要写入目录时，优先固定目录、所有权和挂载时序，再决定是否允许非致命启动。

常见问题

只改了 WorkingDirectory，为什么相对配置仍然找不到？

先确认程序实际读取的相对路径，再用 systemctl show 看最终值。配置文件可能被环境变量或启动参数覆盖，目录设置只影响当前目录。

WorkingDirectory 会自动创建目录吗？

不会。目录不存在时通常会在启动阶段失败；使用 - 只能改变缺失目录的失败策略，不能生成目录。

修改 unit 后 restart 仍使用旧目录怎么办？

先执行 systemctl daemon-reload，再重启；随后检查 FragmentPath、DropInPaths 和 WorkingDirectory，排除编辑了错误文件或 drop-in 覆盖。