Micronaut外部类无Bean内省问题排查求助

问题描述 #

引入外部库中的类后，启动Micronaut应用时出现内省错误，提示目标类没有可用的Bean内省信息。

复现步骤 #

1. 共享库（已启用Micronaut注解处理）中定义如下DTO：

@Data
@Serdeable.Deserializable
public class HeaderABC {
  private Map<String, Object> headerAttrib;
}

2. 在Micronaut项目中引入该类并定义请求类：

@Data
@Serdeable.Deserializable
@JsonIgnoreProperties(ignoreUnknown = true)
public class RequestA {
  HeaderABC header;
}

3. 启动应用时抛出错误：

Internal Server Error: No bean introspection available for type [class HeaderABC]. Ensure the class is annotated with io.micronaut.core.annotation.Introspected

已尝试但无效的操作 #

• 在HeaderABC类上添加@Introspected注解
• 在RequestA类上添加@SerdeImport(HeaderABC.class)注解

解决办法 #

1. 确保共享库正确生成内省类 #

如果共享库使用Maven，需确认注解处理器依赖和配置正确：

<!-- 添加必要依赖 -->
<dependency>
    <groupId>io.micronaut</groupId>
    <artifactId>micronaut-core</artifactId>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>io.micronaut.serde</groupId>
    <artifactId>micronaut-serde-processor</artifactId>
    <scope>provided</scope>
</dependency>

<!-- 配置Maven编译器插件，开启注解处理 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <annotationProcessorPaths>
            <path>
                <groupId>io.micronaut</groupId>
                <artifactId>micronaut-core-processor</artifactId>
                <version>${micronaut.version}</version>
            </path>
            <path>
                <groupId>io.micronaut.serde</groupId>
                <artifactId>micronaut-serde-processor</artifactId>
                <version>${micronaut.serde.version}</version>
            </path>
        </annotationProcessorPaths>
        <compilerArgs>
            <arg>-Amicronaut.processing.group=你的共享库groupId</arg>
            <arg>-Amicronaut.processing.module=你的共享库artifactId</arg>
        </compilerArgs>
    </configuration>
</plugin>

如果是Gradle项目，添加注解处理器依赖：

annotationProcessor("io.micronaut:micronaut-core-processor")
annotationProcessor("io.micronaut.serde:micronaut-serde-processor")

构建完成后，检查共享库的jar包中是否包含META-INF/io.micronaut/introspections目录及对应内省文件。

2. 在Micronaut项目中显式指定内省目标类 #

无需修改外部库代码，在项目中创建一个配置类，通过@Introspected的targets属性指定需要内省的外部类：

@Introspected(targets = HeaderABC.class)
public class ExternalClassIntrospectionConfig {
}

此配置会强制Micronaut为该外部类生成内省信息。

3. 清理缓存并重新构建 #

执行以下命令清理构建缓存后重新构建项目：

• Maven：mvn clean install
• Gradle：gradle clean build
  之后重启应用验证问题是否解决。

内容的提问来源于stack exchange，提问作者Nikhil N gowda