---
title: 连接数相关参数与异常场景说明-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于连接数相关参数与异常场景说明相关的常见问题和使用技巧，帮助您快速解决连接数相关参数与异常场景说明的难题。
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

划线反馈

# 连接数相关参数与异常场景说明

更新时间：2026-06-03 03:01

适用版本： V2.1.x、V2.2.x、V3.1.x、V3.2.x 内容类型：TechNote  

本文主要说明了 OceanBase 数据库全链路中，连接数相关参数的以及相关异常场景说明。

## 适用版本

OceanBase 数据库 V2.x、V3.x 版本。

## 连接数相关参数说明

- Druid 中连接数的相关参数 (建议采用 Druid1.2.8 及以上版本 )

     - `maxActive`：最大连接数。
     - `initialSize`：初始创建的连接数。初始化发生在显示调用 `init` 方法，或者第一次 `getConnect` 时。
     - `minIdle`：最少可以保留的空闲连接数。
 - OBProxy

     - `client_max_connections`：一个 OBProxy 支持的最大客户端连接数；可以通过修改 OBProxy 中的这个参数来调整数据库的最大连接数。该参数的范围为 `[0，65535]`，默认值为 `8192`。
 - OBServer

     - `max_connections`：用于设置允许使用的 FD 最大值，当前仅 MySQL 模式支持该系统变量。其默认值为 `2147483647`，取值范围为 `[1,2147483647]`。该变量修改后，需要重启 OBServer 节点才能生效。一般不需要修改。
     - `max_user_connections`：用于指定单个用户可以向 OBServer 节点建立的连接数。当前仅 MySQL 模式支持该系统变量。其默认值为 `0`，表示不限制连接数；该变量修改后，需要重启 OBServer 节点才能生效。一般不需要修改。

## 连接数的设置依据

- 业务最大并发数。
 - 业务架构。
 - 数据库性能、负载情况。
 - 连接池的配置。
 - 租户个数。

## 空闲连接占用的资源

- OBProxy 一个文件句柄、端口号
 - OBServer 一个文件句柄、端口号
 - 占用 OBProxy 35k 内存
 - 占用 OBServer 386k 内存

## 参数设置建议

- 如果使用 DNS 进行连接，并且需要调整最大连接数，那么要考虑单个 OBProxy 能满足所有连接数的情况。
 - Druid 连接池设置建议：`minIdle 、initialSize <= maxActive`。
 - 连接数配置原则：1.5 至 2 倍的冗余，即 `(maxActive * 应用进程个数(连接池个数) + 非连接池使用连接个数 ) * 租户数 * (1.5-2) < client_max_connections`。

## 场景测试

- 场景 1：Druid 连接池满。

  错误信息如下：

  ```shell
  Exception in thread "main" com.alibaba.druid.pool.GetConnectionTimeoutException:
  wait millis 60005, active 2, maxActive 2,
  creating 0

  ```
 - 场景 2：OBProxy 连接数满。

  错误信息如下：

  ```shell
  Too many sessions

  ```
 - 场景 3：OBServer 连接数满。

  错误信息如下：

  ```shell
  User 'root' has exceeded the 'max_user_connections' resource (current value: xxx)

  ```
 - 场景 4：OBServer 连接数满。

  错误信息如下：

  ```shell
  com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException: Too many connections

  ```

Previous

[如何查看 OBProxy 的连接数](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000000029)

Next

[File Handle 对 OBProxy 连接数上限影响](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000245501) ![有帮助](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) 咨询热线