尝试连接Quarkus Axon应用至AxonIQ Console时触发空指针异常

基于Quarkus的Axon应用未使用Spring框架，尝试连接AxonIQ Console，已引入console-framework-client依赖（版本1.4.0）并配置AxoniqConsoleConfigurerModule，但启动时触发NullPointerException，提示EventProcessorManager的transactionManager参数为null，应用也未显示在AxonIQ Console中。

依赖配置 #

<dependency>
    <groupId>io.axoniq.console</groupId>
    <artifactId>console-framework-client</artifactId>
    <version>1.4.0</version>
</dependency>

Axon配置代码 #

Configurer configurer = DefaultConfigurer.defaultConfiguration() //
    .configureAggregate(MyAggregate.class)
    .configureSerializer(config -> commmandSerializerForAxonServer());
AxoniqConsoleConfigurerModule
        .builder(
                "95d0cfd4-0",
                "f3094e246fd84ae6a9e4cde5d12fe2f7",
                "MyAxonProject"
        )
        .build()
        .configureModule(configurer);

Configuration configuration = configurer.start();

异常信息 #

Caused by: java.lang.NullPointerException: Parameter specified as non-null is null: method io.axoniq.console.framework.eventprocessor.EventProcessorManager.<init>, parameter transactionManager
at io.axoniq.console.framework.eventprocessor.EventProcessorManager.<init>(EventProcessorManager.kt)
at io.axoniq.console.framework.AxoniqConsoleConfigurerModule.lambda$configureModule$3(AxoniqConsoleConfigurerModule.java:135)
at org.axonframework.config.Component.get(Component.java:85)
at org.axonframework.config.DefaultConfigurer$ConfigurationImpl.getComponent(DefaultConfigurer.java:1134)
at org.axonframework.config.Configuration.getComponent(Configuration.java:278)
at io.axoniq.console.framework.AxoniqConsoleConfigurerModule.lambda$configureModule$6(AxoniqConsoleConfigurerModule.java:146)
at org.axonframework.config.Component.get(Component.java:85)
at org.axonframework.config.DefaultConfigurer$ConfigurationImpl.getComponent(DefaultConfigurer.java:1134)
at org.axonframework.config.Configuration.getComponent(Configuration.java:278)
at io.axoniq.console.framework.AxoniqConsoleConfigurerModule.lambda$configureModule$14(AxoniqConsoleConfigurerModule.java:209)
at org.axonframework.config.DefaultConfigurer.lambda$invokeInitHandlers$57(DefaultConfigurer.java:994)
at java.base/java.util.ArrayList.forEach(ArrayList.java:1596)
at org.axonframework.config.DefaultConfigurer.invokeInitHandlers(DefaultConfigurer.java:994)
at org.axonframework.config.DefaultConfigurer.buildConfiguration(DefaultConfigurer.java:955)
at org.axonframework.config.Configurer.start(Configurer.java:618)
at at.axon.configuration.AxonConfigurer.configure(AxonConfigurer.java:32)

原因 #

AxonIQ Console客户端模块初始化EventProcessorManager时，要求Axon配置中必须存在**事务管理器（TransactionManager）**实例，但当前配置未显式声明该组件，导致注入时获取null触发异常。

解决步骤 #

1. 添加事务管理器配置
   在Axon的DefaultConfigurer中补充事务管理器配置。如果应用无事务需求，可直接使用Axon提供的NoTransactionManager；若需Quarkus原生事务支持，可适配Quarkus的事务管理器。示例代码：

   Configurer configurer = DefaultConfigurer.defaultConfiguration()
           .configureAggregate(MyAggregate.class)
           .configureSerializer(config -> commmandSerializerForAxonServer())
           // 配置无事务管理器（按需替换为实际事务实现）
           .configureTransactionManager(config -> NoTransactionManager.INSTANCE);
   

2. 确认核心组件完整性
   确保Axon配置包含事件处理器、消息总线等核心组件。若使用事件处理器，需通过EventProcessingConfigurer完成相关配置。
3. 校验版本兼容性
   检查console-framework-client（1.4.0）与Axon Framework、Quarkus Axon扩展的版本是否匹配，避免版本冲突导致组件缺失。

完成配置后重启应用，即可解决空指针异常并让应用正常注册到AxonIQ Console。

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