systemd 服务环境变量不生效时，先用 systemctl cat 核对单元和覆盖文件中的 EnvironmentFile 路径，再检查变量文件内容、覆盖顺序和进程启动时间。修改单元需要重新加载管理器配置，已经运行的进程通常还需重新启动才能取得新的启动环境。

适用版本与前提

本文面向使用 systemd 管理系统服务的 Linux，常用命令按 systemd 239 及以上版本选取，具体支持情况以发行版自带手册为准。内容依据 2026 年 11 月 12 日查阅的上游手册整理，示例未在目标主机实测。example.service、/etc/example/app.env 和变量名均为占位示例，需替换为真实配置。用户服务需在相应用户管理器范围内排查。

第一步，核对实际单元和覆盖文件

systemctl --version
systemctl cat example.service
systemctl show example.service -p FragmentPath -p DropInPaths
systemctl status example.service --no-pager --full

先记录版本和单元名。cat 展示磁盘上的主单元与 drop-in 文件，并标出文件路径。show 选择管理器中的路径属性，帮助确认所管理的单元。status 用来查看当前运行状态及启动信息。磁盘文件发生修改后，cat 的内容可能与管理器已加载的配置存在差异，应对照修改和重载时间。systemctl 官方手册

在 [Service] 段寻找 Environment、EnvironmentFile 及相关覆盖项，确认目标变量由哪里设置。多套安装、实例化单元或同名用户服务都可能造成查错对象。

第二步，检查变量文件路径与内容

下面是需要合并到现有服务配置中的片段。先确认文件已存在及业务程序确实读取这些变量。

[Service]
EnvironmentFile=/etc/example/app.env

对应变量文件可采用简单的逐行赋值。

APP_MODE=production
APP_PORT=8080
APP_LABEL="example service"

EnvironmentFile 使用 UTF-8 文本与逐行变量赋值，支持手册定义的引号和转义规则。空行、无等号的行以及以 # 或分号开头的注释行会被忽略。该文件采用专门的解析规则，编写时按变量赋值组织内容，命令执行、路径计算等逻辑应放在适当的程序或启动脚本中。

路径前缀 - 会使文件相关错误被忽略。例如 EnvironmentFile=-/etc/example/app.env 中的文件缺失，可能让服务继续启动却缺少预期变量。排查时应核对前缀、绝对路径及管理器读取文件时的文件系统视图。EnvironmentFile 官方语法与读取时机

第三步，查同名变量覆盖顺序

EnvironmentFile 中的赋值可覆盖 Environment 的赋值。多个变量文件设置同一变量时，后读取的文件优先。沿单元与 drop-in 中的配置检查所有来源，记录哪个文件最后赋值，再核对程序自身配置文件、命令行参数是否另有优先级。程序如何使用变量，需要以应用文档和实际行为验证。systemd 环境文件覆盖规则

诊断输出和单元内容可能暴露配置值。环境变量本身也可能经管理接口和进程树传播，密码、令牌等应按应用与平台支持的凭据机制管理。环境变量的安全边界

第四步，按修改范围应用并验证

如果修改了单元或 drop-in，在保存差异、检查配置且满足业务变更条件后，先执行第一条重新加载管理器配置，再按服务安排执行第二条。restart 会停止后重新启动服务，需评估中断和依赖影响。

sudo systemctl daemon-reload
sudo systemctl restart example.service

daemon-reload 重新加载单元配置，运行进程的环境不会因此自动刷新。若只是修改既有 EnvironmentFile 指向的文件内容，上游说明管理器会在执行服务进程前读取文件，因此应在下一次启动时核验新值。服务的 reload 行为还取决于其实现，应查看对应应用说明。管理器重载与服务重启说明

  1. 再次查询同一个单元的状态，确认新启动时间与本次操作对应。
  2. 通过应用已有的非敏感配置诊断、日志或可验证业务行为，确认目标变量实际被采用。只看到文件已改，仍需完成此项验证。
  3. 检查启动后的错误及真实业务请求。异常时按保存的差异恢复配置，再按同样流程应用和验证。

常见问题

在终端 export 后，服务为什么仍没有变量？

系统服务由 systemd 管理器启动。排查应回到服务声明的环境来源，并检查应用启动方式。用终端手工启动程序的结果，需要与服务的用户、目录和配置条件对照。

改完变量文件后服务启动失败，先查哪里？

先保存完整状态和对应启动时间的日志，再核对文件路径、可读性、赋值规则以及应用对变量值的校验。本站文章给出了按单元与时间窗口查询日志的方法。systemd 服务启动失败与 journalctl 取证步骤