修改Java代码重启Wildfly服务器后改动仍不生效如何排查

问题场景 #

Wildfly以Debug模式启动后，断点可以正常命中进入对应方法，但方法内新增的打印语句、新增变量均不生效，重启服务器后问题依旧，当前Wildfly配置参考：

排查方向 #

1. 优先检查Eclipse编译环节问题 #

• 查看顶部菜单栏Project分类下的Build Automatically是否勾选，未勾选时保存代码不会触发自动编译，Debug模式挂载的会一直是旧版本class文件
• 右键项目进入Build Path > Configure Build Path，切换到Source标签，检查每个源码目录对应的Output folder是否指向项目部署路径下的WEB-INF/classes，如果输出路径配置到和部署目录无关的位置，代码改动自然不会同步到运行中的应用
• 手动执行Project > Clean，选中出问题的项目做强制全量重编译，编译完成后直接到输出目录查找对应类的class文件，确认文件修改时间为当前操作时间，排除增量编译缓存损坏导致未生成新class的问题
• 查看Eclipse底部Problems视图，确认当前项目无编译报错；只要存在未解决的编译错误，Eclipse就不会替换旧class文件，会一直运行最后一次编译成功的版本，很多人会忽略非当前文件的隐藏编译报错

2. 检查Wildfly部署逻辑与缓存问题 #

• 打开Servers视图双击已配置的Wildfly服务器，在配置页检查Server Locations配置，确认部署路径为当前工作空间对应的部署目录，没有指向历史使用过的外部旧部署路径
• 彻底清理Wildfly旧缓存：停掉服务器，进入Wildfly安装目录，删除standalone/deployments下和项目同名的war包、.war.deployed、.war.failed等所有关联标记文件，再清理standalone/tmp、standalone/data/content目录下和项目相关的缓存文件，避免服务器加载残留的旧部署包
• 检查Wildfly部署扫描配置：打开standalone/configuration/standalone.xml，找到deployment-scanner配置项，确认scan-enabled="true"、auto-deploy-exploded="true"；如果项目体积较大，可以适当调小scan-interval、调大deployment-timeout，避免扫描间隔过长或超时未识别到新的class文件
• 如果是Maven/Gradle项目，先在命令行执行一次mvn clean install（Gradle对应执行gradle clean build），再刷新Eclipse内的项目，排除构建工具输出路径和Eclipse输出路径不一致，导致服务器加载本地Maven仓库中旧版本项目jar包、而非当前修改源码的问题
• 如果是EAR包嵌套WAR的部署结构，右键项目进入Deployment Assembly检查装配规则，确认修改代码对应的模块是直接关联源码输出，而非引用本地导出的旧jar包

3. 检查Debug热替换的规则限制 #

• JDK自带的HotSwap热替换仅支持方法体内部的代码修改，如果改动涉及类结构调整——比如新增/删除方法、新增/修改类成员变量、修改类继承关系/实现接口，即使是Debug模式也无法热替换生效，这类改动必须重新部署
• 打开Eclipse设置Window > Preferences > Java > Debug，找到Hot code replacement板块，确认所有选项已勾选，并且将替换失败的行为设置为弹出提示，避免之前选择了替换失败静默忽略，导致热替换失败无感知
• 断点命中时，可以在Expressions视图执行表达式this.getClass().getResource(this.getClass().getSimpleName() + ".class")，查看当前JVM加载的class文件实际路径，确认路径指向当前工作空间的编译输出目录，而非第三方依赖包或其他旧目录下的同名类；类加载优先级问题会导致JVM加载依赖包中的同名类，此时修改项目内的代码不会生效

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