systemd服务无法正确向Golang二进制传递参数的问题

问题原因 #

核心问题在于systemd的变量展开逻辑和shell完全不同：

• 当你在ExecStart中使用"${ADDITIONAL_FLAGS}"时，systemd会将ADDITIONAL_FLAGS的整个值作为单个命令行参数传递给Golang程序，而非像shell那样将带空格的字符串拆分成多个独立参数。
• 例如ADDITIONAL_FLAGS="--foo bar --baz qux"，systemd会把这整串作为一个参数传给程序，而Go的flag包是按单个参数解析的，自然无法识别其中的--foo、bar等选项。
• ps -ef看起来参数正确是因为它只是拼接显示命令行字符串，不会区分实际的参数拆分情况，但程序内部的os.Args列表里，这部分是一个单独元素，而非多个。

另外，脚本生成的/opt/staging.env中ADDITIONAL_FLAGS没有引号并非直接原因——即使加了引号，systemd也不会像shell那样解析引号，只会把引号当作参数的一部分。

解决建议 #

方案1：通过shell执行，利用shell的参数拆分能力 #

修改systemd服务的ExecStart，用bash启动程序，让shell处理参数拆分：

[Service]
# 保留原有其他配置
ExecStart=/bin/bash -c '/opt/bin/agent --health-path=${HEALTH_PATH} --health-interval-seconds=${HEALTH_INTERVAL_SECONDS} ${ADDITIONAL_FLAGS}'

这种方式和你手动在shell中执行的效果完全一致，shell会自动将ADDITIONAL_FLAGS的值拆分成多个独立参数。

方案2：生成独立启动脚本（适合复杂场景） #

如果需要更灵活的启动逻辑，可以修改原脚本生成一个完整的启动脚本，再让systemd执行该脚本：

1. 修改原脚本，在生成staging.env后添加以下内容：

cat > /opt/start-agent.sh <<EOF
#!/bin/bash
source /opt/staging.env
/opt/bin/agent --health-path=\${HEALTH_PATH} --health-interval-seconds=\${HEALTH_INTERVAL_SECONDS} \${ADDITIONAL_FLAGS}
EOF
chmod +x /opt/start-agent.sh

2. 修改systemd服务的ExecStart：

[Service]
# 保留原有其他配置
ExecStart=/opt/start-agent.sh

方案3：避免拼接参数变量（长期推荐） #

尽量不要将多个参数拼接成单个环境变量。可以修改原脚本，直接将每个额外参数作为独立配置项，或者在生成systemd服务文件时直接写入完整的ExecStart命令，彻底绕过环境变量拼接的问题。

验证方法 #

可以在Golang程序中添加一行代码打印实际收到的参数，确认拆分情况：

package main

import (
	"fmt"
	"os"
)

func main() {
	fmt.Printf("Received args: %#v\n", os.Args)
	// 原有业务逻辑...
}

重新编译后运行，对比systemd启动和手动启动的输出，就能直观看到参数拆分的差异。

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