踩坑记：给 systemd 写 JVM 参数，翻车 3 次才学会

坑一：反斜杠续行的"隐形空格"（最痛的那个）

我写了这样一行：

Environment="JAVA_TOOL_OPTIONS=\
-Xms256m -Xmx384m \
-XX:MaxMetaspaceSize=96m"

直觉告诉我：反斜杠 + 换行 = 纯粹去掉换行，拼接成一长串。我错了。

systemd 的续行规则是： + 换行 → 替换成一个空格。 所以上面那段实际被拼成了：

\

JAVA_TOOL_OPTIONS= -Xms256m -Xmx384m ...
                   ↑
              这里多了一个空格！

JVM 拿到这个环境变量，解析参数时第一个 token 是空的，直接把整条丢弃了。

症状：

• systemctl cat ydt.service 里 drop-in 好好的 ✅
• /proc/$PID/environ 里 JAVATOOLOPTIONS 值正确 ✅
• 但 ps aux 看不到 -Xmx384m ❌
• ydt.log 里没有 "Picked up JAVATOOLOPTIONS" ❌

排查过程：我一开始以为是本地文件有空格，用 PowerShell 逐字符查 ASCII 码，发现本地文件没问题。是用户在服务器上跑 cat -A 才发现了真相——systemd 拼接时偷偷插入的空格。

正确写法：把第一个值直接跟在等号后面，反斜杠只放在值与值之间：

Environment="JAVA_TOOL_OPTIONS=-Xms256m -Xmx384m -XX:MaxMetaspaceSize=96m \
-XX:+UseG1GC -XX:+ExitOnOutOfMemoryError"

这样拼接后：

JAVA_TOOL_OPTIONS=-Xms256m -Xmx384m -XX:MaxMetaspaceSize=96m -XX:+UseG1GC ...
                   ↑ 等号后直接跟参数，没有空格 ✅

坑二：%p 到底是谁的 pid

我写了：

-XX:ErrorFile=/data/springboot/logs/hs_err_pid%p.log

我的设想：JVM OOM 时生成 hs_err_pid12345.log（12345 是 JVM 进程的 PID）。

结果：jcmd 输出里看到的是 ErrorFile=...hs_err_pidydt.log。

systemd 和 JVM 都有 %p 这个 specifier，但含义完全不同：

• systemd 的 = 服务名前缀（对 ydt.service 就是 ydt）

%p

• JVM 的 = JVM 进程 PID

%p

systemd 在把 Environment 值传给进程之前，先把 %p 替换成了 ydt，JVM 拿到的已经是字面量 hs_err_pidydt.log 了。

修正：用 %%p 让 systemd 输出字面量 %p，这样 JVM 拿到的才是 hs_err_pid%p.log，它会自己把 %p 替换成 PID：

-XX:ErrorFile=/data/springboot/logs/hs_err_pid%%p.log

经验：在 systemd 配置里写任何带 % 的 JVM 参数（%p、%t、%e 等），都要检查是不是和 systemd 的 specifier 撞了。撞了就加双 %%。

坑三：ps 看不到 ≠ 没生效

改完坑一之后，用户跑了 ps aux | grep java，说："怎么还是没生效？ps 里看不到 -Xmx384m 啊！"

这里有个认知差：OpenJDK 17 不会把 JAVATOOLOPTIONS 注入的参数写回 。

/proc/$PID/cmdline

• /proc/$PID/cmdline = 进程启动时的原始命令行（java -jar xxx.jar ...）
• JAVATOOLOPTIONS 注入的参数 = JVM 内部 VM flags，不修改 cmdline

所以 ps（读 cmdline）看不到，但 JVM 内部确实在生效。

正确的验证方式：用 jcmd PID VM.flags 读 JVM 内部实际生效的 flags：

/www/server/java/jdk-17.0.8/bin/jcmd $PID VM.flags | grep MaxHeapSize
# 预期: -XX:MaxHeapSize=402653184  (= 384MB, 说明生效了)

这次跑出来的结果一切正常：

InitialHeapSize=268435456    (= 256MB, 对应 -Xms256m)
MaxHeapSize=402653184        (= 384MB, 对应 -Xmx384m)
MaxMetaspaceSize=100663296   (= 96MB, 对应 -XX:MaxMetaspaceSize=96m)
+UseG1GC                     (对应 -XX:+UseG1GC)

经验：验证 JVM 参数是否生效，别信 ps，信 jcmd。ps 能看到的只是 JVM 启动时的原始命令行，JAVATOOLOPTIONS、CATALINA_OPTS 这类环境变量注入的参数，不会反映到 cmdline 上。

一句话总结

这三个坑里，坑一最隐蔽（systemd 文档里提了一嘴但没加粗标红），坑二最容易复现（任何带 % 的 JVM 参数都撞），坑三最容易误导排查方向。写完这份总结，下次再给 systemd 写 Environment 不会再栽了。