WSO2 EI 7.1.0部署存储过程API后无法在仪表盘显示求助

可能的核心原因 #

• MySQL驱动缺失：本地Integration Studio默认集成了常用数据库驱动，但EI服务器环境未配置对应驱动，导致API初始化时无法加载数据库连接，最终不显示在API列表。
• CAR包依赖打包不完整：项目POM.xml未正确配置数据库相关依赖的打包规则，导致CAR包缺少数据源配置、数据库 mediator 依赖或驱动文件，部署后无法正常初始化API。
• 服务器端初始化报错：API部署过程中因数据源配置错误（如连接串、账号密码）、存储过程不存在、数据库权限不足等问题触发初始化失败，EI会静默跳过故障API的加载，不在列表显示。
• 版本兼容性问题：Integration Studio 8.0部分特性可能超出EI 7.1.0的支持范围，导致生成的API配置无法被EI解析。
• 部署目录权限或解压异常：CAR包未被正确解压到EI的API部署目录（repository/deployment/server/synapse-configs/default/api/），或运行用户无读写权限，导致EI无法识别该API。

针对性解决步骤 #

1. 补全MySQL驱动 #

• 将对应版本的MySQL驱动jar（如mysql-connector-java-8.0.30.jar）复制到EI服务器的repository/components/lib/目录，重启EI服务。
• 若需通过CAR包自动携带驱动，修改项目POM.xml中MySQL依赖的scope为compile：

  <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.30</version>
      <scope>compile</scope>
  </dependency>
  

  重新生成CAR包后部署。

2. 验证CAR包完整性 #

• 解压生成的CAR包，检查是否包含：
  • API的synapse配置文件（*.xml，位于synapse-configs/default/api/路径下）
  • 数据源配置文件（若使用了自定义数据源，位于conf/datasources/路径下）
  • 数据库相关依赖jar（若配置了打包依赖）
• 核对POM.xml中的<dependencies>节点，确保wso2-carbon-datasource等EI核心数据库依赖已正确引入。

3. 查看服务器日志定位错误 #

• 打开EI服务器的repository/logs/wso2carbon.log，搜索以下关键字定位故障：
  • API的名称
  • ERROR级别的日志条目
  • API deployment failed、Datasource initialization failed等关键词
• 根据日志提示修复问题，例如修正数据源连接串、核对数据库账号权限、确认存储过程存在性。

4. 检查部署目录与权限 #

• 查看EI的repository/deployment/server/synapse-configs/default/api/目录，确认是否存在该API的配置文件。若不存在，手动将API的xml配置文件复制到该目录，重启EI。
• 确保EI运行用户对repository/deployment/目录拥有读写权限，避免因权限不足导致CAR包无法解压。

5. 核对版本兼容性 #

• 查阅WSO2官方兼容性文档，确认Integration Studio 8.0与EI 7.1.0的适配性。若存在不兼容：
  • 降级Integration Studio至与EI 7.1.0匹配的版本（如Studio 7.1.0）
  • 升级EI至支持Studio 8.0的版本（如EI 7.2.0及以上）
  • 修改项目配置，移除EI 7.1.0不支持的特性（如某些新的mediator或配置语法）

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