Tomcat环境下Apache Camel通过JNDI引用数据源失败如何解决

Apache Camel完全可以正常对接Tomcat提供的JNDI数据源，不需要为不同容器维护两套配置。你遇到的是Tomcat JNDI上下文适配、类加载隔离导致的运行时错误，按下面的步骤调整即可复现WebLogic环境下的正常运行效果。

• 当前Spring JNDI查找配置缺少Tomcat适配参数，拿到的数据源对象是Tomcat生成的动态代理，Camel JDBC组件执行连接操作时无法正确识别代理类型、加载对应驱动类，因此启动阶段不报错，实际执行SQL才抛出异常。
• WebLogic的JNDI实现对Spring的默认查找逻辑兼容性更好，所以同一份配置在WebLogic可正常运行，Tomcat下失效。
• 你贴的日志只输出了最外层的CamelExecutionException包装异常，没有打印根因栈，实际触发错误的基本都是类加载冲突、代理对象类型不匹配这两类问题。

1. 调整JNDI数据源配置 #

修改camel-config.xml中的dataSourceHello bean配置，补充Tomcat适配的关键属性，修改后的配置可同时兼容Tomcat、WebLogic两类容器：

<bean id="dataSourceHello" class="org.springframework.jndi.JndiObjectFactoryBean"> 
    <property name="jndiName" value="java:comp/env/jdbc/deapplication-datasource"/>
    <!-- 标记为容器托管资源，适配Tomcat JNDI上下文查找逻辑 -->
    <property name="resourceRef" value="true"/>
    <!-- 明确指定查找返回的对象类型，解决动态代理识别失败问题 -->
    <property name="expectedType" value="javax.sql.DataSource"/>
    <!-- 启动阶段就完成JNDI查找，提前暴露配置错误，避免运行时才发现问题 -->
    <property name="lookupOnStartup" value="true"/>
</bean>

2. 校验Tomcat配置与依赖 #

你现有的server.xml、context.xml配置本身没有语法问题，只需要确认两个容易踩的坑：

• Oracle JDBC驱动包必须放在Tomcat根目录的lib文件夹下，不要放在应用的WEB-INF/lib目录。Tomcat的JNDI数据源由公共类加载器加载，优先读取Tomcat lib下的依赖，放在应用内会触发类加载冲突，导致连接创建失败。
• 确认context.xml中的ResourceLink配置归属你部署的Camel应用对应的Context节点，server.xml中的Resource配置放在GlobalNamingResources节点下，不要写错层级。

3. 多环境免切换配置（可选） #

如果需要同时支持本地无容器开发、容器部署场景，不需要手动注释切换配置，可以用Spring Profile做环境隔离：

<!-- Tomcat/WebLogic容器环境激活 -->
<beans profile="container">
    <bean id="dataSourceHello" class="org.springframework.jndi.JndiObjectFactoryBean"> 
        <property name="jndiName" value="java:comp/env/jdbc/deapplication-datasource"/>
        <property name="resourceRef" value="true"/>
        <property name="expectedType" value="javax.sql.DataSource"/>
    </bean>
</beans>

<!-- 本地开发/单元测试环境激活 -->
<beans profile="dev">
    <bean id="dataSourceHello" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
        <property name="driverClassName" value="oracle.jdbc.OracleDriver" />
        <property name="url" value="jdbc:oracle:thin:@//test-cluster:1521/foo.bar.ca" />
        <property name="username" value="yada" />
        <property name="password" value="nada" />
    </bean>
</beans>

容器启动时添加JVM参数-Dspring.profiles.active=container即可自动加载JNDI配置，本地开发指定dev profile直连数据库，全程不需要修改配置文件。

调整完成后重启Tomcat，再调用healthCheckDb对应的REST接口，即可看到路由中日志2正常打印，dual表查询成功，和WebLogic环境的运行表现完全一致。

如果调整后仍然报错，在日志配置中开启org.springframework.jndi、org.apache.camel.component.jdbc包的DEBUG级别日志，打印完整异常根因栈，90%以上的同类问题通过上述配置调整都可以解决。

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