501-frameworks-micronaut-core

Micronaut Core 指南

应用 Micronaut 核心指南，涵盖 DI、配置、HTTP 适配器和运维。

此技能涵盖哪些内容？

• 使用 Micronaut.run(Application.class, args) 实现精简的 main
• Bean 作用域：@Singleton、@Prototype；仅在有充分理由时使用请求作用域
• 使用 jakarta.inject.Inject 进行构造函数注入
• 使用 @Factory 构造第三方 Bean 或显式创建 Bean
• 使用 @ConfigurationProperties（分组设置），而非零散的 @Property
• 使用 @Requires 和环境配置，而不是在领域代码中分支处理环境变量
• 保持 @Controller 类型精简，将工作委托给 @Singleton 服务
• 使用 @Scheduled，并确保故障清晰可见
• 对阻塞 I/O 使用 @ExecuteOn(TaskExecutors.BLOCKING)（或虚拟线程执行器），避免阻塞事件循环
• 配置 Netty 优雅关闭属性
• 使用 AOP 拦截器处理横切关注点

范围： 根据参考规则和优劣代码示例应用建议。

约束

应用 Micronaut 更改前，确保项目能够编译。如果编译失败，请立即停止。改进完成后，运行完整验证。

• 强制要求：应用任何更改前，运行 ./mvnw compile 或 mvn compile
• 前提条件：项目必须成功编译，才能应用 Micronaut 核心改进
• 安全要求：如果编译失败，请立即停止——编译失败属于阻断条件
• 验证：应用改进后，运行 ./mvnw clean verify 或 mvn clean verify
• 开始应用前：阅读参考文档，了解详细规则、优劣模式和约束

何时使用此技能

• 审查 Java 代码中的 Micronaut 应用结构和 Bean
• 应用 Micronaut 配置、@Requires 和工厂的最佳实践
• 改进 Micronaut 服务中的调度、关闭或线程处理
• 审查 Micronaut 依赖注入作用域和工厂
• 为环境配置 Micronaut @Requires 条件

工作流

1. 阅读参考文档并评估项目上下文

阅读 references/501-frameworks-micronaut-core.md，并在提出更改前检查当前项目设置。

2. 确定范围并决定目标改进

明确所需结果、约束，以及要应用的最小安全更改集。

3. 应用符合框架规范的更改

按照参考模式和项目惯例实现或重构配置/代码。

4. 运行验证并报告结果

执行适当的构建/测试，并总结更改内容、验证情况以及任何后续操作。

参考

详细指南、示例和约束请参阅 references/501-frameworks-micronaut-core.md。