在 micronaut 项目中，若依赖了含 openapi 相关注解的模块但未正确配置对应注解处理器，编译时会抛出 error finalizing type visitor [...] null 异常；根本原因是 openapiapplicationvisitor 缺少必要的编译期支持。
该错误通常出现在跨模块协作场景中：当一个公共库（如 common 模块）引入了 OpenAPI 注解（例如 @Operation、@Schema 等），但其 Gradle 构建脚本未声明 micronaut-openapi 的注解处理器时，下游 Micronaut 应用在编译阶段加载该库并触发 OpenAPI 类型访问器（OpenApiApplicationVisitor）时，因无法解析相关元数据而崩溃——即使该库自身不生成 OpenAPI 文档，只要其代码或依赖传递引入了 OpenAPI 注解类，就可能触发此问题。
根本解决方式是显式添加 OpenAPI 注解处理器。请在 common 模块的 build.gradle 中补充以下任一依赖（推荐前者，兼容性更佳）：
annotationProcessor "io.micronaut.openapi:micronaut-openapi:${micronautVersion}"或（仅需注解支持时）：
annotationProcessor "io.micronaut.openapi:micronaut-openapi-annotations:${micronautVersion}"⚠️ 注意事项：
- micronaut-openapi 的版本必须与主 micronautVersion 严格一致（如 3.8.2），否则可能因 SPI 接口变更导致 null 异常；
- 不要仅添加 implementation 或 api 依赖，必须使用 annotationProcessor，因为 OpenApiApplicationVisitor 是编译期类型访问器，需在 annotation processing 阶段被发现并注册；
- 若项目同时使用 micronaut-openapi 生成文档，还需确保 openapi 插件或相关配置已启用，但本问题中仅需处理器即可修复构建失败；
- 移除 mavenLocal() 并非合理方案（如题所述涉及本地依赖闭环），正确做法是完善注解处理器而非规避仓库。
验证方法：执行 ./gradlew clean compileJava，确认不再出现 Error finalizing type visitor 日志；随后重新 publishToMavenLocal 并在下游项目中构建，应可正常通过。该方案已在 Micronaut 3.7.5+ 多个版本中稳定生效，是官方推荐的标准化修复路径。
