非GCP环境用Google Cloud Debug设断点报标识符未找到问题

核心原因 #

你遇到的变量找不到错误，核心原因是代码编译时未携带局部变量调试符号。
Java编译器javac默认仅会生成行号、源文件两类调试信息，不会保留局部变量名的符号表，调试代理无法将表达式中的i映射到栈上的实际变量，就会抛出标识符不存在的错误。

解决方案 #

1. 重新编译代码补充调试符号 #

• 直接用javac编译的场景，添加-g参数生成完整调试信息：

  javac -g FooMain.java
  

• Maven项目场景，在maven-compiler-plugin中开启debug配置：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
      <debug>true</debug>
      <debuglevel>lines,vars,source</debuglevel>
    </configuration>
  </plugin>
  

• Gradle项目场景，在build.gradle中添加编译配置：

  compileJava {
      options.debug = true
      options.debugOptions.debugLevel = "lines,vars,source"
  }
  

2. 快速验证定位 #

你可以先修改断点表达式为静态变量SHARED_INT测试，如果可以正常输出日志，就能100%确认是局部变量符号表缺失的问题。

3. 额外注意项 #

Java 11部分版本默认开启的类数据共享(CDS)、JVM激进优化参数（如-O、-XX:+EliminateLocalVariables）也可能会擦除局部变量信息，你可以在启动时添加-XX:-EliminateLocalVariables参数规避优化导致的变量丢失问题。

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