升级SpringFramework至6.x.x后无法加载camel-context.xml求助

将SpringFramework依赖从5.3.34版本升级至6.1.14版本后，运行代码时出现报错。核心依赖（spring-core、spring-web等）版本统一使用${spring-version}。

项目通过以下代码加载配置文件：

ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("camel-context.xml");

该操作触发错误，精简后的camel-context.xml配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd
                           http://www.springframework.org/schema/context
                           http://www.springframework.org/schema/context/spring-context.xsd">
    <camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
            <routeBuilder ref="deleteReportRoute"></routeBuilder>
    </camelContext>
</beans>

报错信息：

org.springframework.beans.factory.BeanDefinitionStoreException: Unexpected exception parsing XML document from class path resource [camel-context.xml]
    at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.doLoadBeanDefinitions(XmlBeanDefinitionReader.java:426)
    ...
Caused by: org.springframework.beans.FatalBeanException: Unresolvable class definition for NamespaceHandler class [org.apache.camel.spring.handler.CamelNamespaceHandler] for namespace [http://camel.apache.org/schema/spring]
    ...

已知信息：

• 所有SpringFramework依赖版本一致；
• 主pom.xml中原本包含3.6.0版本的camel-spring依赖，尝试升级至最新版本后问题仍未解决；
• 移除camel-context.xml中的<camelContext>标签后，项目可正常运行，但服务无法监听任何端点。

1. 确认Camel与Spring 6.x的兼容性 #

Spring 6.x要求JDK 17+，Camel从3.20.0开始才正式支持Spring 6。3.6.0版本完全不兼容Spring 6，若升级时选的是Camel 3.x的旧分支，仍会存在兼容性问题。推荐直接升级到Camel 4.x（完全适配Spring 6.1.x），或至少升级到Camel 3.20.0及以上版本。

2. 统一Camel依赖版本 #

确保所有Camel相关依赖（包括camel-spring）版本统一，且适配Spring 6：

• 若使用Camel 4.x，选择4.0+版本（如4.7.0），其默认适配Spring 6.1.x；
• 若坚持使用Camel 3.x，需升级到3.20.0+，同时通过spring-framework-bom管理Spring版本，避免依赖冲突。

3. 更新XML Schema地址 #

Camel 4.x的Spring命名空间Schema地址已更新，需修改camel-context.xml中的xsi:schemaLocation：

http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring-4.0.xsd

若使用Camel 3.20+，Schema地址格式不变，但需指定对应版本（如camel-spring-3.22.xsd）。

4. 排查类加载冲突 #

• 执行mvn dependency:tree查看依赖树，确认org.apache.camel.spring.handler.CamelNamespaceHandler类存在于camel-spring依赖中；
• 若存在重复依赖，排除冲突的Spring或Camel组件，示例：

  <dependency>
      <groupId>org.apache.camel</groupId>
      <artifactId>camel-spring</artifactId>
      <version>${camel-version}</version>
      <exclusions>
          <exclusion>
              <groupId>org.springframework</groupId>
              <artifactId>spring-context</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

5. 优化Spring上下文加载方式（可选） #

Spring 6.x中ClassPathXmlApplicationContext仍可用，但推荐使用注解式加载：

@Configuration
@ImportResource("classpath:camel-context.xml")
public class CamelConfig {
}

然后通过AnnotationConfigApplicationContext加载配置，能减少XML配置的兼容性问题。若项目允许，建议迁移到Spring Boot自动配置，进一步简化配置。

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