Spring Boot 3中R2DBC MariaDB故障转移配置连接异常求助

可能的原因及修复步骤 #

1. 确认R2DBC MariaDB驱动版本兼容性 #

Spring Boot 3要求适配的R2DBC驱动版本，确保你的pom.xml（Maven）或build.gradle（Gradle）中引入的r2dbc-mariadb版本符合Spring Boot 3的依赖管理。通常Spring Boot 3.0+对应io.r2dbc:r2dbc-mariadb 1.1.x及以上版本。

2. 修正URL格式并添加故障转移参数 #

你当前的URL格式缺少故障转移的显式配置，MariaDB R2DBC驱动需要明确启用故障转移机制。正确的URL格式应包含failover=true参数，同时可补充连接超时等配置：

spring:
  r2dbc:
    url: r2dbc:mariadb://localhost:3306,localhost:3307/test?failover=true&connectTimeout=5000&socketTimeout=30000
    username: your_username
    password: your_password

• failover=true：启用故障转移逻辑，主节点不可用时自动切换至备用节点
• connectTimeout：设置连接超时时间，避免长时间等待无响应节点
• socketTimeout：设置套接字超时时间，防止连接挂起

3. 验证节点可达性与权限 #

确保两个MariaDB节点：

• 网络可达：应用服务器能正常访问节点的IP和端口，无防火墙或安全组拦截
• 权限一致：连接用的数据库用户在两个节点上都拥有test数据库的访问权限，且密码相同
• 状态正常：两个节点处于运行状态，能通过mysql命令行等常规客户端正常连接

4. 检查连接池配置（若使用） #

如果使用r2dbc-pool连接池，需配置合理的参数，保证连接有效性：

spring:
  r2dbc:
    pool:
      initial-size: 5
      max-size: 20
      validation-query: SELECT 1

连接池会定期验证连接有效性，避免持有失效的节点连接。

5. 排查异常日志细节 #

获取完整的连接异常堆栈日志，重点关注：

• 是否为节点连接拒绝错误
• 是否存在认证失败信息
• 驱动是否抛出明确的故障转移相关错误
  根据日志细节可精准定位问题，比如节点配置错误、驱动不兼容等。

内容的提问来源于stack exchange，提问作者Ramees Puthiya Purayil