---
title: "Failover 和 Load-Balancing 模式概述 - JDBC 驱动程序  V2.4.11 | OceanBase 文档中心"
description: Failover 和 Load-Balancing 模式概述 OceanBase Connector/J 支持 Failover 和 Load-Balancing 模式：loadbalance 模式。 loadbalance 模式 loadbalance 模式在多主机环境中支持连接 Load-Balancing。此模…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*bhcER5Qvet8AAAAAAAAAAAAADiGDAQ/original) JDBC 驱动程序 V 2.4.11

# Failover 和 Load-Balancing 模式概述

更新时间：2026-07-22 17:46:00

[编辑](https://github.com/oceanbase/connector-j-doc/edit/V2.4.11/zh-CN/300.user-guide/900.failover-and-load-balancing/100.failover-and-load-balancing-overview.md)  

OceanBase Connector/J 支持 Failover 和 Load-Balancing 模式：loadbalance 模式。

## loadbalance 模式

`loadbalance` 模式在多主机环境中支持连接 Load-Balancing。此模式不支持从属服务器的 Load-Balancing 读取。连接器通过从每个连接 URL 中随机选择一个主机来对所有查询执行 Load-Balancing。由于连接随机分布在所有主机上，因此查询实现 Load-Balancing。

## 相关参数

相关参数如下表所示。

| **参数** | **描述** |
| --- | --- |
| autoReconnect | 如果启用了此参数，并且未使用 Failover 和 Load-Balancing 模式，则连接器在连接失败后仅尝试重新连接到主机，这称为 Basic Failover。如果启用了此参数，并且正在使用 Failover 和 Load-Balancing 模式，则连接器会将出现故障的主机列入黑名单，并尝试连接到其他相同类型的主机。这称为 Standard Failover。默认值：`false`。 |
| retriesAllDown | 当连接器正在执行 Failover 并且所有主机都关闭时，此参数用于定义连接器的最大连接尝试次数，以避免引发异常。默认值：120。 |
| failoverLoopRetries | 当连接器静默搜索有效主机时，此参数用于定义连接器的最大连接尝试次数，以避免引发异常。此参数不同于 `retriesAllDown` 参数，此静默搜索用于连接器的临时解决方案，例如在从属连接失败时使用主连接执行读取。默认值：120。 |
| validConnectionTimeout | 当配置了多个主机时，连接器在所设置的时长（以秒为单位）之内，不会丢失验证连接。当此参数设置为 0 时，将不进行任何验证。默认值：120 s。 |
| loadBalanceBlacklistTimeout | 当连接失败时，此主机将被列入此参数所定义的时长黑名单。当连接到主机时，驱动程序将尝试连接未列入黑名单的主机，只有在未找到主机的情况下，才尝试连接已列入黑名单的主机。此黑名单在类加载器内部共享。默认值：50 ms。 |
| assureReadOnly | 如果使用 Failover 和 Load-Balancing 模式并与主机建立只读连接时启用此参数，将会话设置为只读来确保此连接处于只读模式。 默认值： `false`。 |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线