NetBeans调试WildFly项目报断点位于类外无法设置怎么办

按以下优先级逐一验证，基本可以覆盖Ubuntu环境下NetBeans+WildFly调试的该类问题：

• 修正编译配置，确保class文件带完整调试信息
  NetBeans 13在Ubuntu环境下的增量构建存在已知bug，会漏写class文件的行号映射，同时OpenJDK默认编译参数可能不带完整调试信息：
  1. 如果是Maven项目，在根pom的maven-compiler-plugin配置中强制开启调试参数：

  <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>
  

  2. 关闭NetBeans的增量编译：打开项目属性 > 构建 > 编译，取消勾选「编译后保存」选项
  3. 执行mvn clean install -DskipTests全量构建，不要用NetBeans的快捷构建按钮
• 修复路径不匹配问题（虚拟机环境最高发原因）
  该报错本质是调试器拿到的class文件关联的源码路径，和你本地打开的源码路径不一致，Ubuntu虚拟机环境下常见触发场景：
  1. 项目存放在虚拟机共享文件夹/软链接目录下：NetBeans解析路径时会拿到软链接对应的真实物理路径，和JDWP协议返回的路径不匹配，直接将项目拷贝到虚拟机本地非挂载、非软链接目录（比如~/projects/下）重新打开
  2. 手动配置路径映射：打开工具 > 选项 > Java > 调试器 > 路径映射，新增映射规则：本地源码根目录（对应src/main/java的绝对路径）映射到WildFly部署临时目录下的classes路径，默认路径为WildFly安装目录/standalone/tmp/deployments/你的应用部署包名/WEB-INF/classes/
• 补全OpenJDK调试依赖
  Ubuntu 20.04默认安装的OpenJDK11缺少调试符号包，会导致调试器无法正确解析class结构，执行以下命令安装完整组件后重启环境：

  sudo apt update && sudo apt install -y openjdk-11-dbg openjdk-11-source
  

• 清理NetBeans损坏缓存
  跨系统迁移项目、版本升级后容易出现索引缓存损坏，关闭NetBeans后执行以下命令删除缓存，重启后等待项目全量索引完成再启动调试：

  rm -rf ~/.cache/netbeans/13/
  

• 校验WildFly调试启动参数
  不要自定义修改调试启动参数，直接使用WildFly自带的调试启动命令./standalone.sh --debug，默认调试端口为8787，确认启动参数中没有-Xnoagent、-g:none这类禁用调试信息的配置。

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