本地启动新拉取的Micronaut应用报BeanInstantiationException错误如何解决

问题根因 #

报错提示Multiple possible bean candidates found: [io.micronaut.aop.InterceptorRegistry, io.micronaut.aop.InterceptorRegistry]属于典型的类路径重复依赖问题，同一类型的Bean被多次加载到Micronaut上下文导致冲突。同一份代码同事可以正常运行，排除代码本身问题，冲突只出在你的本地Gradle环境、全局配置或者依赖拉取源的差异上。

解决方案 #

按以下顺序排查修复：

• 清理全量缓存
  很多人只删全局Gradle缓存会遗漏项目级缓存，按顺序执行以下操作：

  1. 在项目根目录执行./gradlew clean清理当前项目构建产物
  2. 删除全局Gradle目录下的wrapper文件夹：rm -rf ~/.gradle/wrapper，避免Gradle wrapper版本差异导致的依赖拉取异常
  3. 删除项目根目录下的隐藏缓存文件夹：rm -rf ./.gradle
  4. 重新执行./gradlew run启动验证

• 校验依赖版本和全局配置

  1. 执行命令./gradlew dependencies | grep micronaut-aop检查是否存在多个版本的micronaut-aop依赖
  2. 核对你本地的~/.gradle/init.gradle全局配置文件，和同事的配置对比，确认是否存在额外的镜像源、依赖版本强制覆盖规则，保持全局配置和同事一致
  3. 确认本地JDK大版本和同事完全一致，Micronaut低版本在JDK17等高版本JDK环境下会出现类加载异常

• 特殊场景处理
  如果你本地安装了Micronaut CLI，确认CLI版本和项目依赖的Micronaut版本一致，版本差异会导致CLI注入的全局依赖和项目依赖冲突，可临时调整环境变量优先级优先使用项目内依赖，或临时卸载CLI验证。

• 临时规避方案
  如果以上排查都未定位到问题，可在项目的application.yml配置中添加规则允许Bean覆盖，临时解决启动问题：

  micronaut:
    context:
      allow-bean-override: true
  

  注意：该方案仅为临时规避，不建议长期在生产环境使用，建议后续定位到依赖冲突根因后移除该配置。

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