Keycloak 21连接MySQL主从集群异常：仅连主节点，从节点闲置求助

1. JDBC URL与驱动参数检查 #

• 先清理URL中的重复节点：当前URL重复了slave2:3306，修正为jdbc:mysql:replication://master:3306,slave1:3306,slave2:3306/keycloak?useSSL=false&failOverReadOnly=false&serverTimezone=UTC，避免驱动解析异常。
• 明确failOverReadOnly=false的作用：该参数仅控制故障转移到从节点后的连接是否只读，不影响正常读请求的路由。可添加autoReconnect=true，避免从节点连接断开后无法自动重建。

2. Keycloak读写路由逻辑验证 #

• 确认数据源配置正确性：检查Keycloak配置文件（如standalone.xml或application.properties），确保数据源的driver-class-name为com.mysql.cj.jdbc.Driver，且URL确实使用replication://协议。
• 排查测试请求类型：Keycloak的写操作（如用户更新、会话创建）会强制走主节点，若测试用例中读请求占比不足，或读请求涉及强一致性场景（如写入后立即读取），驱动会自动路由到主节点。可单独模拟纯读请求（如调用/admin/realms/{realm}/users/{id}接口获取用户信息），观察从节点连接是否被激活。

3. Agoral连接池参数调整 #

• 检查空闲连接回收策略：从节点连接被关闭大概率是连接池的空闲回收机制触发。查看idleTimeout（空闲连接超时）、maxLifetime（连接最大存活时间）参数，若设置过短（如小于30分钟），空闲的从节点连接会被回收且未重建。建议将idleTimeout设为30分钟以上，maxLifetime设为略小于MySQL的wait_timeout（默认8小时）。
• 避免连接池干扰驱动路由：禁用连接池强制设置readOnly属性的配置，让MySQL Replication驱动自行管理主从连接的读写状态。

4. 驱动与版本兼容性排查 #

• 确认MySQL Connector/J版本：Keycloak 21推荐使用8.0.x版本驱动，若驱动版本过低（如5.x），Replication驱动的路由逻辑存在bug，可能导致读请求无法路由到从节点，升级至匹配版本后重新测试。
• 检查从节点同步状态：执行show slave status查看Seconds_Behind_Master，若从节点延迟过高，驱动会自动切换为从主节点读取。

5. 日志定位问题 #

• 开启MySQL驱动DEBUG日志：在Keycloak日志配置中，将com.mysql.cj.jdbc的日志级别设为DEBUG，观察是否有读请求尝试路由到从节点的记录，或从节点连接失败的报错信息。
• 启用连接池日志：查看从节点连接被关闭的具体原因（如空闲超时、连接异常等）。

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