WSO2 EI 6.6.0中如何通过控制面板创建MongoDB数据源？

背景说明 #

WSO2 EI 6.6.0的数据源控制台默认没有MongoDB的可视化配置项，必须通过**自定义数据源（Custom）**类型完成配置，同时需确保驱动包部署正确。

步骤1：部署MongoDB驱动包 #

EI默认不包含MongoDB驱动，需手动添加：

• 下载与你的MongoDB集群版本兼容的Java驱动包（如mongo-java-driver-3.12.11.jar，建议选择3.x版本适配EI 6.6.0）
• 将驱动包复制到<EI_HOME>/repository/components/lib目录
• 重启EI服务器，使驱动生效

步骤2：创建自定义MongoDB数据源 #

进入控制台「Home -> Configure -> Datasources」，点击「Add Datasource」选择Custom类型，按以下配置填写：

基础配置

• Datasource Name: 设置为mongodb-datasource（需与数据服务配置中的carbon_datasource_name完全一致）
• JNDI Name: 填写jdbc/mongodb（或自定义符合规范的名称）
• Description: 可选，添加描述信息

连接配置

• Driver Class Name: 填写org.wso2.carbon.datasource.mongodb.MongoDataSource（WSO2官方适配的Mongo数据源驱动类）
• URL: 构造MongoDB连接URI，对应你原配置的格式为：

  mongodb://User:Pass@mmongodev01:27017,vmmongodev02:27017,vmmongodev03:27017/DatabaseName?readPreference=primary&writeConcern=none
  

• 可选：若不想在URL中嵌入参数，可添加以下属性键值对替代：
  • mongoDB_servers: mmongodev01:27017,vmmongodev02:27017,vmmongodev03:27017
  • mongoDB_database: DatabaseName
  • username: User
  • password: Pass
  • mongoDB_write_concern: NONE
  • mongoDB_read_preference: PRIMARY

验证与保存

点击「Test Connection」确认连接正常，之后保存数据源。

步骤3：关联数据服务 #

确保你的数据服务配置中carbon_datasource_name指向刚创建的数据源：

<config enableOData="false" id="Datasource">
      <property name="carbon_datasource_name">mongodb-datasource</property>
</config>

重新部署数据服务即可生效。

排查要点 #

• 连接失败先检查驱动包是否放置正确、版本匹配，且EI已重启
• 确认EI服务器能访问所有MongoDB节点（网络连通性、端口开放）
• 若用户名/密码含特殊字符，需对其进行URL编码后再写入连接URI

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