WSO2 Integration Studio自定义类中介外部Jar未加载致Oracle连接异常

问题分析 #

抛出的java.lang.ClassNotFoundException: oracle.jdbc.driver.OracleDriver异常，核心原因是Oracle JDBC驱动Jar没有被WSO2的类加载器正确识别加载——哪怕你已经添加了外部Jar，但放置位置或配置逻辑不符合WSO2的类加载规则。

具体解决步骤 #

1. 调整驱动Jar的放置位置 #

• 本地调试场景（Integration Studio内运行）：
  把Oracle JDBC驱动Jar（比如ojdbc8.jar）放到项目根目录下新建的lib文件夹里，右键Jar文件选择Build Path → Add to Build Path。同时要确保Jar被纳入部署工件：

  • 打开项目pom.xml，确认存在类似依赖配置：

    <dependency>
        <groupId>com.oracle.database.jdbc</groupId>
        <artifactId>ojdbc8</artifactId>
        <version>19.3.0.0</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/lib/ojdbc8.jar</systemPath>
    </dependency>
    

  • 或者右键项目→Properties→Deployment Assembly，手动添加该Jar到部署路径中。

• 服务器部署场景（部署到WSO2 EI/APIM）：
  把驱动Jar复制到服务器的<EI_HOME>/lib或<APIM_HOME>/repository/components/lib目录，然后重启服务器。这两个目录属于WSO2的全局类加载路径，能保证驱动被所有组件识别。

2. 修正自定义类的驱动加载逻辑 #

在你的Cdemo.java里，改用WSO2上下文类加载器加载驱动，避免自定义类加载器干扰：

// 替换原有的Class.forName代码
Class.forName("oracle.jdbc.driver.OracleDriver", true, Thread.currentThread().getContextClassLoader());

3. 验证CAR包打包配置 #

导出CAR文件部署时，要确保驱动Jar被包含在内：

• 在Integration Studio中打开Composite Application项目，右键→Export Composite Application Project，在向导里确认包含了驱动Jar所在的模块；
• 导出后解压CAR包，检查lib目录下是否存在Oracle JDBC驱动Jar。

4. 清理缓存并重启 #

• 点击Integration Studio顶部菜单Project→Clean，清理项目后重新构建；
• 本地运行的话，停止当前服务器实例再重启；部署到远程服务器的话，重启服务器后重新部署CAR包。

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