ZooKeeper的systemd服务中EXTRA_ARGS变量未生效问题求助

问题原因 #

systemd 服务运行时默认使用独立的环境变量上下文，不会主动加载 /etc/environment、用户profile等全局环境配置文件。你手动在终端执行启动命令时，终端会话已经加载了/etc/environment里的EXTRA_ARGS变量，所以JMX exporter正常生效，但systemd启动时没有读取到该变量，导致javaagent没有被注入到ZooKeeper的启动参数中。

解决方案 #

方案1：直接在systemd服务配置中定义环境变量（最直接） #

修改你的ZooKeeper systemd服务文件，在[Service]段中添加Environment配置：

[Unit]
Requires=network.target remote-fs.target
After=network.target remote-fs.target

[Service]
Type=simple
User=root
Group=root
# 新增此行定义环境变量
Environment="EXTRA_ARGS=-javaagent:/opt/jmx-exporter/jmx_prometheus_javaagent-0.16.1.jar=7070:/opt/jmx-exporter/zookeeper.yaml"
ExecStart=/opt/kafka/bin/zookeeper-server-start.sh /opt/kafka/config/zookeeper.properties
ExecStop=/opt/kafka/bin/zookeeper-server-stop.sh
Restart=on-abnormal

[Install]
WantedBy=multi-user.target

修改完成后执行以下命令生效：

systemctl daemon-reload
systemctl restart zookeeper # 替换为你的实际服务名

方案2：将变量写入Kafka ZooKeeper专属环境配置文件（适配Kafka生态习惯） #

Kafka自带的启动脚本会自动加载同目录下的zookeeper-env.sh文件，你可以在/opt/kafka/bin/目录下创建该文件，写入变量配置：

echo 'export EXTRA_ARGS="-javaagent:/opt/jmx-exporter/jmx_prometheus_javaagent-0.16.1.jar=7070:/opt/jmx-exporter/zookeeper.yaml"' > /opt/kafka/bin/zookeeper-env.sh
chmod +x /opt/kafka/bin/zookeeper-env.sh

该方案无需修改systemd配置，手动启动和systemd启动都会自动加载变量，后续调整参数也不需要修改systemd配置，适配性更强。

方案3：使用独立环境变量文件（适合多变量场景） #

如果你的服务需要配置多个环境变量，可以统一放到一个独立文件中管理，比如创建/etc/sysconfig/zookeeper写入变量：

EXTRA_ARGS="-javaagent:/opt/jmx-exporter/jmx_prometheus_javaagent-0.16.1.jar=7070:/opt/jmx-exporter/zookeeper.yaml"

然后在systemd服务的[Service]段添加配置：

EnvironmentFile=/etc/sysconfig/zookeeper

配置完成后同样需要执行systemctl daemon-reload并重启服务生效。

验证方式 #

配置完成后执行以下命令验证7070端口是否正常监听：

ss -tunlp | grep 7070

也可以直接访问metrics接口确认输出正常：

curl http://localhost:7070/metrics

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