摘要

本文通过实例分析 /etc/profile 在 systemd 服务中失效的原因，指出 systemd 启动服务时不会加载 shell 配置文件。演示了正确设置环境变量的方法：使用 EnvironmentFile 指定变量文件（如 /etc/sysconfig/myapp），并修改 service 文件加载。同时提供了调试技巧（systemctl show 和 env 输出）和替代方案对比，强调 systemd 需要显式声明环境变量。适用于解决服务启动时环境变量丢失的常见问题。

本文通过一个完整实例，演示：

• ❌ 为什么/etc/profile在 systemctl 下无效
• ✅ systemd 正确设置环境变量的方式
• ✅ 如何一步步验证生效

一、示例场景说明

假设我们有一个程序：

• 程序路径：/opt/myapp/app.sh

• 依赖环境变量：

  • JAVA_HOME
  • 自定义PATH

二、错误示例（90% 人都会踩）

1️⃣ 在/etc/profile中写环境变量

# /etc/profileexportJAVA_HOME=/opt/javaexportPATH=/opt/java/bin:$PATH

2️⃣ 服务脚本

# /opt/myapp/app.sh#!/bin/bashecho"JAVA_HOME=$JAVA_HOME"echo"PATH=$PATH"

chmod+x /opt/myapp/app.sh

3️⃣ systemd service 文件（错误写法）

# /etc/systemd/system/myapp.service [Unit] Description=My App Service [Service] ExecStart=/opt/myapp/app.sh [Install] WantedBy=multi-user.target

4️⃣ 启动服务

systemctl daemon-reload systemctl start myapp systemctl status myapp

5️⃣ 结果

JAVA_HOME= PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin

❌完全没有读取/etc/profile

三、原因说明（一句话）

systemd 启动服务时不经过 shell，不是登录会话，因此不会加载/etc/profile

四、正确示例（推荐做法）

✅ 方案一：EnvironmentFile（最佳实践，最推荐）

1️⃣ 创建环境变量文件

mkdir-p /etc/sysconfig

# /etc/sysconfig/myappJAVA_HOME=/opt/javaPATH=/opt/java/bin:/usr/bin:/bin

⚠️ 注意：

• 不要写export
• 只支持KEY=VALUE

2️⃣ 修改 systemd service 文件

# /etc/systemd/system/myapp.service [Unit] Description=My App Service After=network.target [Service] Type=simple EnvironmentFile=/etc/sysconfig/myapp ExecStart=/opt/myapp/app.sh Restart=always [Install] WantedBy=multi-user.target

3️⃣ 重新加载并启动

systemctl daemon-reload systemctl restart myapp

4️⃣ 验证结果

systemctl status myapp

输出类似：

JAVA_HOME=/opt/java PATH=/opt/java/bin:/usr/bin:/bin

✅环境变量正确生效

五、如何调试 systemd 服务环境（必会）

方法一：查看 systemd 解析到的环境变量

systemctl show myapp --property=Environment

方法二：在程序中 dump 环境

env>/tmp/myapp.env

cat/tmp/myapp.env

六、可选方案（不推荐，但你可能会遇到）

⚠️ 方案二：强行 source/etc/profile

[Service] ExecStart=/bin/bash -lc "source /etc/profile && /opt/myapp/app.sh"

❌ 缺点：

• 依赖 shell
• 启动慢
• 环境不可控
• 不符合 systemd 设计理念

仅适合临时兼容旧脚本

七、完整目录结构示例

/opt/myapp/ ├── app.sh /etc/sysconfig/ └── myapp /etc/systemd/system/ └── myapp.service

八、systemd / Docker / profile 对比总结

九、一句话总结

systemd 的世界里，没有/etc/profile，只有“显式环境”。

理解这一点，你就能避免 90% 的：

• systemctl 启动失败
• 手动运行正常、服务运行异常
• 环境变量神秘丢失