Linux systemd 服务读不到 EnvironmentFile 时怎么排查

Linux 服务在命令行里能读到变量，换成 systemd 启动后却变成空值，通常不是程序突然失忆，而是 unit 定义、环境文件和正在运行的进程没有对上。排查这类问题，先看 systemd 实际加载了什么，再看它能否读取文件，最后确认变量是否进入当前 MainPID。

最容易漏掉的是两个动作：修改 unit 或 drop-in 后要执行 systemctl daemon-reload，修改 EnvironmentFile 内容后还要重启服务。前者刷新 unit 定义，后者让新进程重新建立环境。

EnvironmentFile 到底进入了哪一层

先准备一个最小 unit 作为讨论对象。示例中的路径和变量是虚构的，重点是关系，不需要把它照搬到生产机。

[Service]
# unit 只声明环境文件位置，变量值放在独立文件中
EnvironmentFile=/etc/demo-api/demo.env
ExecStart=/usr/local/bin/demo-api

如果服务读不到变量，第一件事不是立刻重启，而是确认 systemd 读到的 unit 是否真包含这行：

# 查看主 unit、drop-in 和最终合并内容
sudo systemctl cat demo-api.service
# 查看 unit 文件路径与 drop-in 路径
sudo systemctl show demo-api.service -p FragmentPath -p DropInPaths
# 检查 unit 语法，避免编辑时留下拼写错误
sudo systemd-analyze verify /etc/systemd/system/demo-api.service

systemctl cat 能暴露几个高频误区：改的是同名旧文件、实际生效的是 .d drop-in，或者新配置还没有被 manager 重新读取。先把这层对齐，后面的文件检查才有意义。

路径和格式问题要单独排除

环境文件建议使用绝对路径，并确认 systemd 运行时能读取它。文件内容按变量赋值组织，不要把交互式 shell 的 export、启动命令或条件判断混进去：

# /etc/demo-api/demo.env：每行一个变量赋值
APP_MODE=production
APP_PORT=8080
APP_REGION="cn-east"

然后检查文件是否真的存在、权限是否允许服务管理环境读取，以及变量名是否拼写一致：

如果 unit 使用了带减号的 -EnvironmentFile=，文件缺失可能不会直接让服务失败。排障阶段不建议用它掩盖缺文件；先让路径错误显形，确认无误后再按业务需要决定是否允许可选文件。

daemon-reload 和 restart 不是一回事

修改 unit 文件、drop-in 或 EnvironmentFile= 这一行后，执行 daemon-reload，它刷新的是 systemd manager 对 unit 定义的认识；修改环境文件里的变量值，则需要让服务重新创建进程。一个清晰的收敛动作是：

只执行 daemon-reload 不会自动把旧服务进程替换掉；只执行 restart 也不能保证 manager 已经读到你刚改过的 unit。把两个动作混在一起，是“文件明明改了但服务仍用旧值”的主要来源。

从实际 MainPID 反向验证

服务状态为 active 只说明 unit 目前处于运行状态，不等于目标变量已经进入正确进程。可以先取出 MainPID，再读取该进程的环境键名：

如果 unit 已包含正确声明、日志没有权限或解析错误，但 MainPID 里仍没有变量，重点回看是否只做了 reload 没有 restart，以及是否查看了错误的实例名。若变量已经进入进程而应用仍报空值，问题就应转到应用自身的配置读取逻辑，而不是继续修改 systemd。

一张表收束排查顺序

常见问题

改完 EnvironmentFile 后一定要 daemon-reload 吗？

如果只改文件里的变量值，核心动作是 restart；如果同时改了 unit 中的 EnvironmentFile= 声明、drop-in 或其他 unit 配置，就先 daemon-reload，再 restart。

为什么手工执行程序能读到，systemd 启动却读不到？

手工启动继承的是当前 shell 环境，systemd 服务使用的是 unit 和环境文件构造出的进程环境。应以 systemctl cat、服务日志和目标 MainPID 的 /proc 环境为准，不要用登录 shell 的 env 代替验证。

相关官方资料

• systemd.service 官方手册
• systemctl 官方手册
• systemd.exec 官方源码文档