Spring Boot升级Java17启动报错：无法生成BasicErrorController的CGLIB子类

1. 切点规则未做范围限制：BasicErrorController是Spring Boot官方自带的错误处理控制器，类上标注了@RestController和@RequestMapping注解，完全匹配你定义的切面规则，会被AOP逻辑生成代理类。
2. JDK版本兼容性差异：Java 17相比Java 11加强了类定义校验，同一个类加载器下不允许重复定义同名类。你使用的Spring Boot 2.5.6版本自带的CGLIB版本较低，对JDK17的适配不完善，在Docker环境通过Fat Jar的LaunchedURLClassLoader加载时，会出现代理类重复生成的问题，触发LinkageError。Java11下该校验规则宽松，只会静默覆盖重复类，不会抛出异常，因此之前运行正常。
3. 运行环境类加载逻辑差异：IntelliJ IDE运行时直接加载本地解压的class文件，使用的类加载器逻辑和Fat Jar内的LaunchedURLClassLoader不同，不会触发重复类定义的校验错误，因此本地运行正常。

• 限制切面包范围（最推荐）
  就是你当前使用的方案，通过within指定切面仅匹配自身项目的根包，不仅能彻底避免匹配到第三方依赖的Bean，还能减少不必要的代理生成，提升启动性能，优化后的切点示例：

  @Pointcut("@within(org.springframework.web.bind.annotation.RestController) && within(one.goranson..*)")
  void restController() {}
  

• 排除指定类/官方依赖包
  如果有特殊场景不能限制全局包范围，可以通过!within规则排除不需要代理的类，比如直接排除Spring官方所有类，或者单独排除BasicErrorController：

  // 排除Spring官方所有类
  @Pointcut("@target(restController) && !within(org.springframework..*)")
  void restController(RestController restController) {}
  

• 升级Spring Boot版本
  Spring Boot 2.6及以上版本正式支持JDK17，对CGLIB代理生成逻辑、高版本JDK类加载适配都做了大量优化，升级到2.7.x及以上的稳定版本，可以从根源避免这类兼容性问题。
• 优化切点匹配规则
  改用@within替代@target匹配类上的@RestController注解，@within匹配时机更早，不会触发不必要的类初始化，也能降低代理类重复生成的概率；同时可以把请求注解的匹配范围扩展到@GetMapping/@PostMapping等派生注解，覆盖更多业务场景。
• 调整代理策略（不推荐全局配置）
  可以在application.properties中添加配置spring.aop.proxy-target-class=false，强制使用JDK动态代理生成代理类，BasicErrorController本身实现了ErrorController接口，适配JDK动态代理规则，也能解决该问题，但全局修改代理策略可能影响其他自定义Bean的代理逻辑，需谨慎使用。

内容的提问来源于stack exchange，提问作者Hans-Christian