---
title: 解决云数据库 OceanBase 连接问题-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于解决云数据库 OceanBase 连接问题相关的常见问题和使用技巧，帮助您快速解决解决云数据库 OceanBase 连接问题的难题。
---
切换语言

- 简体中文
- English

划线反馈

# 解决云数据库 OceanBase 连接问题

更新时间：2026-07-24 10:01

内容类型：TechNote  

## 问题现象

无法连接公有云数据库。

## 问题原因

数据库无法连接的可能原因如下：

- 公网地址、私网地址设置错误。
 - 未在白名单中添加测试连接本地白名单 IP/IP 段。
 - 账号密码填写错误。
 - 连接租户模式不正确。
 - ECS 客户端的实例网络类型不属于专有网络。

     - ECS 客户端与云数据库 OceanBase 的实例不在同一地域。
     - ECS 客户端与云数据库 OceanBase 租户的 VPC 不一致。

## 解决方法

### 检查公网地址、私网地址

1. 登录 [OceanBase 管理控制台](https://oceanbasenext.console.aliyun.com)。
 2. 在 **集群列表** 页面，选择需检查的集群。单击集群名称，进入 **集群工作台**。
 3. 在左导航栏中单击 **租户管理**，进入 **租户列表** 页面。单击租户名称，进入 **租户工作台**。
 4. 在 **部署关系图** 部分，查看您的私网地址和公网地址。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-1.png)

   #### 说明

   默认租户创建申请内网地址，如为公网连接，请单击申请公网地址。

### 检查白名单设置

1. 登录 [OceanBase 管理控制台](https://oceanbasenext.console.aliyun.com)。
 2. 在 **集群列表** 页面，选择需要检查的集群。单击集群名称，进入 **集群工作台**。
 3. 在左导航栏单击 **安全设置**。
 4. 在 **安全设置** 的 **白名单分组** 中，查看并确认是否添加测试连接本地白名单 IP/IP 段等。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-2.png)

   #### 说明

      - 集群中安全设置的白名单分组为集群级别生效（即针对所有租户生效），因此添加的白名单无法区分租户和内外网地址类型。租户也可以配置仅针对本租户生效的白名单，实际可访问租户的白名单为两者的合集。
      - 通过外网或内网访问云数据库 OceanBase 所设置的白名单地址：
            - 内网访问：白名单的地址段应该设置为 ECS 实例的内网地址。
            - 外网访问：确认白名单添加的设备公网 IP 地址为设备真正的出口 IP 地址，而非本机的内网 IP。有关添加白名单分组的操作步骤，请参见 [设置白名单分组](https://www.oceanbase.com/docs/common-oceanbase-cloud-10000000001780091)。

### 检查账号密码

1. 登录 [OceanBase 管理控制台](https://oceanbasenext.console.aliyun.com)。
 2. 在左侧导航栏中，单击 **集群列表**。
 3. 在集群列表中选择目标集群，单击目标进群进入 **集群工作台**。
 4. 在租户列表中单击目标租户，即可进入 **租户详情** 页面。
 5. 在左导航栏单击 **账号管理**。
 6. 在 **账号管理** 列表中的 **操作** 列中，单击对应账号的 **修改密码**，重置账号密码，重试连接。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-3.png)

   #### 说明

   数据库连接时候避免账号密码输入两端带空格，以及粘贴时候带隐藏字符等情况。

### 检查连接租户模式

1. 登录 [OceanBase 管理控制台](https://oceanbasenext.console.aliyun.com)。
 2. 在左侧导航栏中，单击 **集群列表**。
 3. 在集群列表中选择目标集群，单击目标集群进入 **集群工作台**。
 4. 在租户列表中单击目标租户，即可进入 Oracle 或 MySQL 模式租户工作台页面。
 5. 在租户工作台页面，单击右上方的 **登录数据库** 按钮，登录 ODC。
 6. 在 ODC 首页的 **个人连接** 页签中，单击 **新建连接**。
 7. 选择租户的所属区域（公有云）并确认连接模式（MySQL/Oracle）是否正确。

      - MySQL 租户

       ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-4.png)

       #### 说明

       OBClient 连接格式：obclient -h[租户域名地址] -u[租户用户名称] -P3306 -p[租户密码]
      - Oracle 租户

       ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-5.png)

       #### 说明

       OBClient 连接格式：obclient -h[租户域名地址] -u[租户用户名称] -P1521 -p[租户密码]

### 检查 ECS 客户端实例的网络类型

确认 ECS 客户端的实例网络类型为专有网络。

![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-6.png)

### 检查 ECS 客户端与云数据库 OceanBase 的实例所属地域

确认 ECS 客户端与云数据库 OceanBase 的实例在同一地域。

![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-7.png)

### 检查 ECS 客户端与云数据库 OceanBase 租户 VPC

内网连接情况下，需保证访问的客户端 VPC 与云数据库 OceanBase 集群内被访问租户的 VPC 相同，保证网络畅通。

#### 说明

此场景是指跨 VPC 之间网络访问未通过特殊手段连接的情况，内网标准访问时 VPC 需保持一致。

1. 查看云数据库 OceanBase 租户所属 VPC。

      1. 登录 [OceanBase 管理控制台](https://oceanbasenext.console.aliyun.com)。
      2. 在左侧导航栏中，单击 **集群列表**。
      3. 在集群列表中选择目标集群，单击目标进群进入 **集群工作台**。
      4. 在租户列表中单击目标租户，即可进入 Oracle 或 MySQL **租户详情** 页面。
      5. 在基础信息区域查看云数据库 OceanBase 的 **用户 VPC**。

   ![8](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-8.png)
 2. 查看 ECS 客户端所属 VPC。

      1. 登录 [云服务器 ECS](https://ecs.console.aliyun.com/home?spm=a2c4g.357646.0.0.58023e06ZyZTJB)。
      2. 在左侧导航栏中，单击 **实例与镜像** > **实例**。
      3. 在 **实例详情** 的 **网络信息** 中，可查看 **专有网络** 的 VPC。

   ![9](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/cloud/cloud-database/fix-errors-of-OB-links-9.png)
 3. 确认云数据库 OceanBase 的 **用户 VPC** 与 **专有网络** 的 VPC 是否相同。

Previous

[租户切换 SLB 后，DMS 无法链接](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000032581)

Next

[磁盘使用率高的常见原因](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000032583) ![有帮助](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) 咨询热线