MicronautApplication 启动失败报“No bean of type [xxx] exists”是因为默认不扫描所有类，需显式添加@Singleton等Micronaut作用域注解、确保包路径被@MicronautApplication覆盖、外部jar需正确声明依赖并含beans.xml或启用注解处理器。
为什么 MicronautApplication 启动失败，报 No bean of type [xxx] exists
这是 Micronaut 最常卡住新手的第一关：它默认不扫描所有类，必须显式声明可注入的组件。Spring Boot 那套“加个 @Service 就自动注册”的习惯在这里会直接失效。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确保目标类上有
@Singleton、@Prototype或@Controller等 Micronaut 的作用域注解，不能只用@Component（那是 Spring 的） - 检查类是否在
src/main/java下且包路径被主类的@MicronautApplication所在包覆盖；Micronaut 默认只扫描同包及子包 - 如果类在外部 jar 或独立模块中，需在
build.gradle中确认该依赖已声明为implementation（不是compileOnly），且其META-INF/micronaut/beans.xml存在（或启用注解处理器自动生成）
Gradle 构建时 micronaut-cli 生成的项目跑不起来，提示 Could not resolve org.micronaut:micronaut-inject
Micronaut 对 Gradle 版本和插件兼容性很敏感，尤其当你用新版 Gradle（8.0+）但模板仍基于旧版 BOM 时，依赖解析容易断裂。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 优先使用
sdk install micronaut安装官方 CLI，并用mn create-app myapp --build=gradle生成项目，避免手动拼配置 - 检查
gradle.properties是否含org.gradle.configuration-cache=true—— Micronaut 4.x 尚不完全支持配置缓存，建议临时关掉 - 确认
build.gradle中plugins { id "io.micronaut.application" version "4.5.0"的版本与micronautVersion属性一致，二者错位会导致micronaut-inject版本拉取错乱
@Client 接口调用远程服务返回 HttpClientException: Connection refused
Micronaut 的 @Client 是编译期生成代理的，不会像 Spring Cloud OpenFeign 那样自动 fallback 到 localhost:8080。URL 必须明确指定，否则默认为空，运行时就炸。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在接口上用
@Client(id = "myapi", url = "https://api.example.com")显式写死地址；id用于后续配置超时等参数 - 更推荐用配置驱动：
@Client(id = "myapi")+micronaut.http.services.myapi.url: https://api.example.com写进application.yml - 注意路径拼接规则：如果
@Get("/v1/users")和url = "https://api.example.com"组合后是https://api.example.com/v1/users，不是.../api/v1/users—— 多余的斜杠或少斜杠都会 404
本地开发时热重载没反应，改了 @Controller 方法要重启整个应用
Micronaut 的 dev-mode 热重载只对部分变更生效，比如模板、静态资源、配置文件；但 Java 类的字节码变更默认不触发 reload，除非你开了特定开关。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 启动命令必须带
--watch参数：./gradlew run --watch（Gradle 7.6+）或./gradlew run --continuous（旧版） - 确保
build.gradle中启用了 annotation processor：annotationProcessor("io.micronaut:micronaut-inject-java")，否则编译期生成的代理类不会随源码更新 - IDE 要识别 Micronaut 的注解处理路径，IntelliJ 需勾选
Settings > Build > Compiler > Annotation Processors > Enable annotation processing，并设为Obtain processors from project classpath
真正麻烦的是跨模块依赖更新——比如你改了一个被多个 @Client 引用的 DTO，它的 jar 包没重新 install 到本地 maven 仓库，dev-mode 就永远读不到新字段。这种地方不报错，只默默用旧 class，得靠日志里打印的类加载路径去核对。
