WSO2 Identity Server是否支持MySQL集群？需哪些步骤与脚本？

一、支持情况确认 #

WSO2 Identity Server完全支持MySQL集群部署，适配主从复制、Galera Cluster等常见MySQL集群架构，可通过配置数据库连接池及集群适配参数实现高可用部署。

二、部署步骤 #

1. 准备MySQL集群环境 #

• 搭建目标MySQL集群（如主从复制或Galera Cluster），确保节点间数据同步正常，且所有节点可被WSO2 IS服务器访问
• 在集群主节点创建WSO2 IS所需数据库（如WSO2_IDENTITY_DB、WSO2_SHARED_DB），依赖集群同步机制将库结构同步至所有从节点

2. 配置WSO2 IS数据库连接 #

• 修改<IS_HOME>/repository/conf/datasources/master-datasources.xml中的默认数据源配置，替换为MySQL集群的JDBC URL（支持负载均衡/故障转移格式）
  示例Galera Cluster的JDBC URL：

  jdbc:mysql://node1:3306,node2:3306,node3:3306/WSO2_IDENTITY_DB?autoReconnect=true&useSSL=false&failOverReadOnly=false&roundRobinLoadBalance=true
  

• 调整连接池参数适配集群负载，同时开启连接有效性校验：

  <datasource>
      <name>WSO2_IDENTITY_DB</name>
      <description>Identity Server核心业务数据库</description>
      <jndiConfig>
          <name>jdbc/WSO2IdentityDB</name>
      </jndiConfig>
      <definition type="RDBMS">
          <configuration>
              <url>jdbc:mysql://node1:3306,node2:3306,node3:3306/WSO2_IDENTITY_DB?autoReconnect=true&useSSL=false&failOverReadOnly=false&roundRobinLoadBalance=true</url>
              <username>wso2_db_user</username>
              <password>wso2_db_pass</password>
              <driverClassName>com.mysql.cj.jdbc.Driver</driverClassName>
              <maxActive>50</maxActive>
              <maxWait>60000</maxWait>
              <testOnBorrow>true</testOnBorrow>
              <validationQuery>SELECT 1</validationQuery>
              <validationInterval>30000</validationInterval>
          </configuration>
      </definition>
  </datasource>
  

3. 执行数据库初始化脚本 #

• 在MySQL集群主节点执行WSO2 IS提供的初始化脚本（数据会自动同步至从节点）：
  • 身份核心数据库脚本：<IS_HOME>/dbscripts/identity/mysql.sql
  • 共享组件数据库脚本：<IS_HOME>/dbscripts/shared/mysql.sql
  • 若使用OAuth2、SCIM等特性，需执行对应脚本，例如OAuth2脚本：<IS_HOME>/dbscripts/identity/oauth2/mysql.sql

4. 验证集群部署有效性 #

• 启动WSO2 IS服务器，查看<IS_HOME>/repository/logs/wso2carbon.log，确认无数据库连接错误
• 执行用户创建、服务提供者配置等操作，检查MySQL集群所有节点的数据同步情况
• 模拟单节点故障（关闭某一MySQL节点），验证WSO2 IS是否自动切换至可用节点，服务无中断

三、关键注意事项 #

• 将MySQL JDBC驱动包（mysql-connector-java-*.jar）放置在<IS_HOME>/repository/components/lib目录下
• 针对不同集群架构调整JDBC URL参数：主从复制需设置failOverReadOnly=false确保写操作仅发往主节点；Galera Cluster可启用roundRobinLoadBalance实现读写负载均衡
• 定期监控集群节点状态及WSO2 IS数据库连接池指标，避免连接泄漏或集群同步异常

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