Spring Integration升级后MBean重复注册失败问题求助

问题核心 #

升级到Spring 6.1.3、Spring Integration 6.2.1、Java 17并部署到Tomcat 10后，<int:router>生成的MBean出现重复注册异常，即使给router添加唯一id也无效——原因是特定Router对应的RouterFactoryBean编号未递增，导致生成重复的MBean名称（如org.springframework.integration.router:name=org.springframework.integration.config.RouterFactoryBean#0,type=MethodInvokingRouter）。

可行解决方案 #

1. 显式指定MBean的唯一名称 #

Spring Integration默认自动生成MBean名称，当自动编号逻辑异常时，直接手动指定唯一的objectName即可避免冲突。在<int:router>标签中通过mbean-export配置自定义名称：

<int:router id="orderTypeRouter" input-channel="orderInputChannel" expression="payload.orderType" mbean-export="true">
    <int:mapping channel="onlineOrderChannel" value="ONLINE"/>
    <int:mapping channel="offlineOrderChannel" value="OFFLINE"/>
    <int:mbean-export object-name="org.springframework.integration.router:name=orderTypeRouter,type=MethodInvokingRouter"/>
</int:router>

这样MBean会使用你指定的名称，不再依赖自动生成的FactoryBean编号。

2. 排查Spring上下文重复加载 #

Tomcat 10的类加载机制与旧版本不同，可能导致Spring配置被重复加载，同一个RouterFactoryBean被多次实例化：

• 检查web.xml中是否存在多个ContextLoaderListener配置
• 确认依赖的其他程序是否加载了相同的Spring集成配置文件
• 排查是否存在父子上下文重复初始化的情况

3. 升级Spring Integration到最新补丁版本 #

6.2.1版本可能存在MBean编号生成的bug，建议升级到同分支的最新补丁版本（如6.2.3），这类自动编号异常通常会在后续补丁中修复。

4. 调整异常Router的初始化逻辑 #

那个编号未递增的Router可能存在特殊的初始化场景（比如依赖延迟加载Bean、初始化顺序异常）：

• 给该Router设置lazy-init="false"，强制提前初始化
• 检查该Router的依赖链，是否存在循环依赖导致初始化中断，进而影响FactoryBean的编号计数

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