Spring Boot 3引入Avro依赖后生成Native Image失败求助

异常场景 #

项目引入 Avro 依赖 implementation("org.apache.avro:avro:1.11.1")，执行 ./gradlew nativeCompile 生成 Native Image 时触发空指针异常：

2022-12-19T12:29:21.693+01:00  INFO [metrics,,] 81039 --- [           main] o.s.c.s.binder.DefaultBinderFactory      : Pre-creating binder child context (AOT) for kstream
2022-12-19T12:29:21.695+01:00  INFO [metrics,,] 81039 --- [           main] o.s.c.s.binder.DefaultBinderFactory      : Pre-creating binder child context (AOT) for ktable
2022-12-19T12:29:21.696+01:00  INFO [metrics,,] 81039 --- [           main] o.s.c.s.binder.DefaultBinderFactory      : Pre-creating binder child context (AOT) for globalktable
Exception in thread "main" java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because the return value of "java.lang.Class.getCanonicalName()" is null
        at org.springframework.aot.hint.BindingReflectionHintsRegistrar.shouldSkipMembers(BindingReflectionHintsRegistrar.java:75)
        ...
> Task :processAot FAILED

问题根源是 org.apache.avro.JsonProperties$1（匿名内部类）的 getCanonicalName() 返回 null，导致 Spring AOT 处理反射提示时触发空指针。

解决办法 #

1. 升级 Avro 版本 #

Avro 1.11.2 及后续版本修复了匿名内部类的相关问题，直接升级依赖到最新稳定版即可：

implementation("org.apache.avro:avro:1.11.2") // 推荐使用更高稳定版如1.12.0

2. 自定义 RuntimeHintsRegistrar 排除目标类 #

如果暂时无法升级 Avro，可通过自定义 Spring AOT 反射规则跳过该匿名类的处理：

• 创建自定义注册类：

import org.springframework.aot.hint.RuntimeHints;
import org.springframework.aot.hint.RuntimeHintsRegistrar;

public class AvroRuntimeHints implements RuntimeHintsRegistrar {
    @Override
    public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
        // 排除JsonProperties的匿名内部类，避免AOT处理时触发空指针
        hints.reflection().registerType(org.apache.avro.JsonProperties.class, 
            hint -> hint.withMembers(memberHint -> memberHint.skipType())
        );
    }
}

• 在启动类上注册该规则：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.ImportRuntimeHints;

@SpringBootApplication
@ImportRuntimeHints(AvroRuntimeHints.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 配置文件中排除绑定处理（临时规避） #

在 application.properties 中添加配置，让 Spring AOT 跳过目标类的绑定处理：

spring.aot.binding.exclude=org.apache.avro.JsonProperties$1

注意：该配置仅兼容部分 Spring Boot 版本，使用前需确认版本匹配。

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