如何通过Cloud Code插件在Kubernetes中调试启动阶段的Java应用

要解决Cloud Code自动添加调试参数导致JVM崩溃，同时实现启动阶段挂起等待调试的需求，你可以用以下几种方法：

方法1：修改VS Code调试配置（最直接） #

Cloud Code允许在launch.json中自定义JVM调试参数，替换默认生成的agentlib配置：

1. 打开VS Code的launch.json文件（若没有，点击调试面板的"创建launch.json文件"，选择Cloud Code Kubernetes类型）
2. 找到对应调试配置块（类型为cloudcode.kubernetes），添加debug字段并指定完整的带suspend=y的JVM参数：

{
  "type": "cloudcode.kubernetes",
  "request": "launch",
  "name": "Run/Debug on Kubernetes",
  "debug": {
    "jvmArgs": "-agentlib:jdwp=transport=dt_socket,server=n,suspend=y,address=${debugAddress},quiet=y"
  },
  // 保留原有配置如"manifest"、"image"等
}

这样Cloud Code会使用你指定的参数，不会再自动生成默认的agentlib配置，JVM启动时会挂起直到调试器连接。

方法2：通过Dockerfile条件化启动命令 #

如果需要更灵活的控制，可以在Dockerfile中根据环境变量调整启动参数，避免重复添加agentlib：

1. 修改Dockerfile的启动命令，增加调试模式判断：

CMD if [ "$DEBUG_SUSPEND" = "true" ]; then \
    java -agentlib:jdwp=transport=dt_socket,server=n,suspend=y,address=${DEBUG_ADDRESS},quiet=y -jar your-app.jar; \
    else \
    java -jar your-app.jar; \
    fi

2. 在launch.json的调试配置中添加环境变量并禁用自动调试参数注入：

{
  "type": "cloudcode.kubernetes",
  "request": "launch",
  "name": "Run/Debug on Kubernetes",
  "env": {
    "DEBUG_SUSPEND": "true",
    "DEBUG_ADDRESS": "${debugAddress}"
  },
  "debug": {
    "disableAutoJvmDebug": true
  },
  // 其他原有配置
}

通过disableAutoJvmDebug参数关闭Cloud Code的自动调试参数注入，完全使用你自定义的启动命令。

注意事项 #

• 不要手动追加-agentlib:jdwp参数，JVM不允许重复定义同名的agentlib参数，这是之前JVM崩溃的原因。
• ${debugAddress}是Cloud Code提供的内置变量，会自动填充调试器的连接地址，无需手动指定固定端口。

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