jrebel热更失效主因是rebel.xml未生成或ide未传-javaagent参数；需验证文件存在、关闭spring boot devtools、配置jrebel.spring-mvc=true，并注意静态字段、字节码增强及远程部署权限问题。
启动JRebel后代码修改不生效？检查rebel.xml生成和IDE集成
JRebel不是“装上就热更”，它依赖两个关键前提：项目能自动生成rebel.xml，且IDE真正把JRebel插件挂进运行时JVM。常见现象是点完“Run with JRebel”后改了Controller方法，刷新页面却还是旧逻辑——大概率是rebel.xml没落在classes/目录下，或IDE没把-javaagent参数传给进程。
实操建议：
- 手动验证：
target/classes/rebel.xml（Maven）或out/production/<project>/rebel.xml</project>（IntelliJ）必须存在，内容里<classpath></classpath>指向的路径得包含你当前编译输出目录 - IntelliJ用户：确认
Run Configuration → Environment → VM options里有类似-javaagent:/path/to/jrebel/jrebel.jar，别只勾了“Enable JRebel”就以为万事大吉 - Maven项目：避免用
spring-boot:run直接启动——它会绕过IDE的JVM参数；改用IDE的“Run”按钮，或在pom.xml里显式配置jrebel-maven-plugin
Spring Boot中Controller改了不热更，但Service改了可以？注意类加载隔离
Spring Boot默认用RestartClassLoader做开发时的快速重启，而JRebel走的是自己的JRebelClassLoader。两者共存会打架：比如@Controller被Spring MVC的RequestMappingHandlerMapping缓存了映射关系，JRebel虽然重载了类，但Spring没刷新路由表。
实操建议：
- 加配置
spring.devtools.restart.enabled=false，关掉Spring Boot DevTools的自动重启，否则它和JRebel抢类加载控制权 - 对
@Controller、@RestController类，JRebel需要额外触发Spring MVC的刷新，可在application.properties里加jrebel.spring-mvc=true（对应JRebel 2022.2+） - 如果用了
@Configuration类定义Bean，记得加上@RefreshScope或启用jrebel.spring-refresh-scope=true，否则Bean实例不会随类重载而重建
热更后出现NoClassDefFoundError或IllegalAccessError？关注静态字段和字节码增强
JRebel重载类时，不会重新执行static块，也不会重置静态字段值；同时，像Lombok、MapStruct这类在编译期插入字节码的工具，若rebel.xml没把生成的class路径纳入扫描，JRebel就看不到新字节码。
实操建议：
- 避免在
static块里做不可逆初始化（如注册监听器、写文件），改用@PostConstruct或Spring的InitializingBean - Lombok项目：确保
rebel.xml里的<classpath></classpath>包含target/generated-sources/annotations/（Maven）或out/production/<project>/generated/</project>（IntelliJ） - 用
javap -c对比热更前后某个方法的字节码，确认Lombok生成的toString()或getter是否真被JRebel加载了
为什么本地热更正常，部署到远程Tomcat就失效？注意JVM启动参数和权限
JRebel必须通过-javaagent挂载，且JVM需允许动态代理。远程环境常因运维脚本硬编码JVM参数、容器限制javaagent、或SELinux阻止mmap调用而失败。
实操建议：
- 远程Tomcat：在
setenv.sh里追加JAVA_OPTS="-javaagent:/opt/jrebel/jrebel.jar $JAVA_OPTS"，别写在catalina.sh里——容易被覆盖 - Docker场景：镜像需安装
libcap2-bin并赋予cap_sys_ptrace+ep能力，否则JRebel的字节码替换会静默失败 - 检查日志：启动时搜
JRebel started和Loaded configuration from，没这两句基本等于没挂上；热更时看Reloading class 'com.example.Xxx'是否出现
JRebel的“热”是有边界的：它不重跑main方法，不重建Spring上下文，也不处理JNI或直接内存操作。最常被忽略的是——你以为改的是A类，实际被热更的是B类（因为模块依赖、类加载器层级或IDE编译缓存）。上线前务必用jrebel-cli验证类加载路径，别只信IDE右下角那个小图标。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
