K8S环境下JVM堆转储文件名配置异常及替换差异排查

主问题：容器启动崩溃的原因及解决方法 #

核心原因 #

环境变量JVM_OPTS中的$(date +%F_%H-%M-%S)和$$是shell命令替换语法，但Kubernetes在定义环境变量时只会将其作为纯字符串存储，不会执行shell解析。当容器通过/bin/sh -c "exec java $JVM_OPTS -jar myapp.jar"启动时，shell展开$JVM_OPTS后，会错误地将$(date识别为要执行的命令，剩余的+%F_%H-%M-%S)_pid$$.hprof"被拆分出来，最终被Java当成了主类名，导致启动失败。

解决方法 #

有三种可行的处理方式：

1. 将shell替换逻辑移到启动命令中
   把需要动态生成的部分从环境变量移到args的命令里，让shell在执行时正确解析：

   spec:
     template:
       spec:
         containers:
         - name: myapp
           command: [ '/bin/sh', '-c' ]
           args:
             - |
               HEAP_DUMP_PATH="/logs/heapdump/hd_$(date +%F_%H-%M-%S)_pid$$.hprof"
               ERROR_FILE="/logs/error/hs_err_$(date +%F_%H-%M-%S)_pid$$.log"
               exec java -XX:+HeapDumpOnOutOfMemoryError \
                 -XX:HeapDumpPath="$HEAP_DUMP_PATH" \
                 -XX:+CrashOnOutOfMemoryError \
                 -XX:OnError=/scripts/threaddump.sh \
                 -XX:ErrorFile="$ERROR_FILE" \
                 -Xlog:gc*=debug:file=/logs/gc/gc_%t_pid%p.log:time,uptimemillis,pid,tid,level,tags \
                 -jar myapp.jar
           # 移除包含shell替换的JVM_OPTS，直接在命令中定义参数
   

2. 使用启动脚本处理动态参数
   如果有多个应用需要复用逻辑，建议编写startup.sh脚本，在脚本中处理动态路径生成：

   # startup.sh内容
   #!/bin/sh
   HEAP_DUMP_PATH="/logs/heapdump/hd_$(date +%F_%H-%M-%S)_pid$$.hprof"
   ERROR_FILE="/logs/error/hs_err_$(date +%F_%H-%M-%S)_pid$$.log"
   exec java -XX:+HeapDumpOnOutOfMemoryError \
     -XX:HeapDumpPath="$HEAP_DUMP_PATH" \
     -XX:+CrashOnOutOfMemoryError \
     -XX:OnError=/scripts/threaddump.sh \
     -XX:ErrorFile="$ERROR_FILE" \
     -Xlog:gc*=debug:file=/logs/gc/gc_%t_pid%p.log:time,uptimemillis,pid,tid,level,tags \
     -jar myapp.jar
   

   然后在K8S YAML中配置：

   spec:
     template:
       spec:
         containers:
         - name: myapp
           command: [ '/bin/sh', '-c' ]
           args:
             - exec /scripts/startup.sh
           volumeMounts:
             - name: startup-script
               mountPath: /scripts/startup.sh
               subPath: startup.sh
         volumes:
           - name: startup-script
             configMap:
               name: startup-config
               defaultMode: 0755
   

3. 使用JVM内置变量替代shell替换
   部分JVM参数支持内置占位符（比如%p表示进程ID），可以避免shell解析：

   env:
   - name: JVM_OPTS
     value: >-
       -XX:+HeapDumpOnOutOfMemoryError
       -XX:HeapDumpPath=/logs/heapdump/hd_%p.hprof
       -XX:+CrashOnOutOfMemoryError
       -XX:OnError=/scripts/threaddump.sh
       -XX:ErrorFile=/logs/error/hs_err_%p.log
       -Xlog:gc*=debug:file=/logs/gc/gc_%t_pid%p.log:time,uptimemillis,pid,tid,level,tags
   

   注：JVM对-XX:HeapDumpPath仅支持%p（进程ID）、%t（当前时间戳，部分高版本JDK支持）等有限占位符，具体需参考对应JDK版本文档。

子问题：%t/%p在不同JVM参数中的差异原因 #

• -Xlog:gc*中的占位符正常解析：-Xlog是JDK 9及以后版本引入的统一日志框架，设计时支持%t（时间戳）、%p（进程ID）等丰富的占位符，这些占位符由JVM自身解析，不需要shell参与。
• -XX:HeapDumpPath中的占位符未被替换：-XX:HeapDumpPath属于传统的JVM非标准参数，其解析逻辑较老，仅在部分高版本JDK中支持%p，不支持%t这类时间占位符。之前配置中的%t和%p未被替换，是因为JVM不解析这些占位符，而shell也没有机会处理（环境变量中的字符串直接传递给JVM），所以最终保留为原始字符串。

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