Systemd etcd服务无法读取environmentFile，首次正常后续失效

问题根源 #

你遇到的情况其实是Systemd的变量解析机制导致的：

• 当你第一次加载etcd服务文件（比如执行systemctl daemon-reload后），Systemd会把ExecStart里的${SELF_IP}这类变量直接替换成/etc/etcd.conf当时的数值，然后把这个替换好的命令缓存起来。
• 后续即使你更新了/etc/etcd.conf，如果没让Systemd重新加载服务配置，它还是会用之前缓存的旧命令——这就是为什么你会看到--name etcd-这种空变量的情况，缓存的命令里变量已经被替换成空或者旧值了。

另外，你用/bin/bash -c包裹etcd命令，但这里的变量解析是Systemd先完成的，轮不到bash去读取新的环境变量，自然就无法应用更新后的配置。

修复方案 #

1. 修改服务文件，让bash负责解析变量

把ExecStart里所有的${变量名}改成\${变量名}，这样Systemd就不会提前解析这些变量，而是把它们原封不动传给bash，由bash在执行时读取最新的环境变量值：

[Unit]
Description=etcd
Documentation=https://github.com/coreos/etcd
Conflicts=etcd.service
Conflicts=etcd2.service

[Service]
Type=notify
Restart=always
RestartSec=25s
LimitNOFILE=40000
TimeoutStartSec=1s
EnvironmentFile=/etc/etcd.conf
ExecStart=/bin/bash -c "/usr/local/bin/etcd --name etcd-\${SELF_IP} --data-dir /var/lib/etcd --quota-backend-bytes 8589934592 --auto-compaction-retention 3 --listen-client-urls http://\${SELF_IP}:2379,http://localhost:2379 --advertise-client-urls http://\${SELF_IP}:2379,http://localhost:2379 --listen-peer-urls http://\${SELF_IP}:2380 --initial-advertise-peer-urls http://\${SELF_IP}:2380 --initial-cluster 'etcd-\${NODE_1_IP}=http://\${NODE_1_IP}:2380,etcd-\${NODE_2_IP}=http://\${NODE_2_IP}:2380,etcd-\${NODE_3_IP}=http://\${NODE_3_IP}:2380' --initial-cluster-token my-etcd-token --initial-cluster-state new"

[Install]
WantedBy=multi-user.target

2. 正确的停止、更新、重启流程

每次修改/etc/etcd.conf后，按以下步骤操作：

• 停止etcd服务：

systemctl stop etcd3

• 运行你的脚本更新/etc/etcd.conf：

INTERNAL_IP=$(ip -o route get to 8.8.8.8 | sed -n 's/.*src \([0-9.]\+\).*/\1/p')
cat << EOF > /etc/etcd.conf
#SELF_IP is the IP of the node where this file resides.
SELF_IP=$INTERNAL_IP
# IP of Node 1
NODE_1_IP=10.128.15.225
#IP of Node 2
NODE_2_IP=10.128.15.226
NODE_3_IP=10.128.15.227
EOF

• 重新加载Systemd服务配置（如果修改了服务文件，这一步必须执行；如果只是更新环境变量，执行它也能确保配置生效）：

systemctl daemon-reload

• 启动etcd服务：

systemctl start etcd3

3. 更优雅的替代方案（可选）

etcd支持直接读取以ETCD_开头的环境变量作为命令行参数，你可以把所有参数都写到/etc/etcd.conf里，这样完全避免变量解析问题：

修改/etc/etcd.conf：

#SELF_IP is the IP of the node where this file resides.
SELF_IP=$(ip -o route get to 8.8.8.8 | sed -n 's/.*src \([0-9.]\+\).*/\1/p')
# IP of Node 1
NODE_1_IP=10.128.15.225
#IP of Node 2
NODE_2_IP=10.128.15.226
NODE_3_IP=10.128.15.227

# etcd 参数
ETCD_NAME=etcd-${SELF_IP}
ETCD_DATA_DIR=/var/lib/etcd
ETCD_QUOTA_BACKEND_BYTES=8589934592
ETCD_AUTO_COMPACTION_RETENTION=3
ETCD_LISTEN_CLIENT_URLS=http://${SELF_IP}:2379,http://localhost:2379
ETCD_ADVERTISE_CLIENT_URLS=http://${SELF_IP}:2379,http://localhost:2379
ETCD_LISTEN_PEER_URLS=http://${SELF_IP}:2380
ETCD_INITIAL_ADVERTISE_PEER_URLS=http://${SELF_IP}:2380
ETCD_INITIAL_CLUSTER="etcd-${NODE_1_IP}=http://${NODE_1_IP}:2380,etcd-${NODE_2_IP}=http://${NODE_2_IP}:2380,etcd-${NODE_3_IP}=http://${NODE_3_IP}:2380"
ETCD_INITIAL_CLUSTER_TOKEN=my-etcd-token
ETCD_INITIAL_CLUSTER_STATE=new

然后服务文件的ExecStart简化为：

ExecStart=/usr/local/bin/etcd

这样Systemd只需要传递环境变量，etcd会自动读取并应用参数，既简洁又不容易出错。

验证配置 #

重启服务后，通过以下命令确认服务正常运行：

# 查看服务状态
systemctl status etcd3
# 实时查看日志
journalctl -u etcd3 -f

如果日志里显示节点名称正确（比如etcd-10.128.15.225），且没有expected IP in URL这类报错，就说明配置生效了。

内容的提问来源于stack exchange，提问作者Jananath Banuka