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

- 简体中文
- English

划线反馈

# 打开或测试连接报错 Access denied

更新时间：2025-06-17 09:01

适用版本： V3.1.x、V3.2.x、V3.3.x、V3.4.x、V4.0.x、V4.1.x、V4.2.x 内容类型：Troubleshoot  

## 问题现象

测试连接或打开连接时报错。

- 报错信息：

  ```shell
  数据库报权限错误，请检查连接配置，确认用户密码正确，且默认数据库为当前用户有权限的库，当前默认数据库为 test，错误详情：Could not connect to address=(host=some.domain.com)(port=2881)(type=master) : (conn=3221531229) Access denied for user 'root'@'xxx.xxx.xxx.xxx' (using password: YES)

  ```
 - 报错信息示例：

   ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/KB/3.common-troubleshooting/2.database-connection/1.open-or-test-connection-error-access-denied/1.png)

## 问题原因

- 数据库账号密码配置错误。
 - 数据库账号无对应数据库的访问权限。
 - 租户白名单配置未包含 ODC 所在机器 IP 地址。
 - MySQL 租户选择了 Oracle 连接类型。

## 解决方法

### **通过 OBClient 连接数据库成功**

如果 Navicat 和 OBClient V1.x 版本能够正常连接数据库而 ODC 连接失败，则此问题因租户白名单配置导致。需要将 ODC 所在机器的 IP 地址配置到租户白名单中。

查看租户白名单是否包含 ODC 所在机器 IP 地址：

```sql
SHOW VARIABLES LIKE 'ob_tcp_invited_nodes';

```

- [系统变量](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220734) `ob_tcp_invited_nodes` 用于设置租户的 IP 白名单，是租户全局的白名单限制参数。默认值：`127.0.0.1,::1`，表示仅允许本机的 IP 连接该租户。
 - `%` 表示允许任何客户端 IP 连接该租户，同时支持短横线（_） 和 IP（多个 IP 之间用逗号分隔），支持 IP 列表匹配、掩码匹配和模糊匹配。

### 通过 OBClient 连接数据库失败

1. 确认数据库账密是否填写正确。
 2. 使用 OBClient 确认数据库账号是否具有对应数据库的访问权限。

   ```sql
   -- OB-MySQL 查看当前用户的被授予的权限
   show grants;

   -- OB-Oracle 查看当前用户被授予的角色
   select * from USER_ROLE_PRIVS;
   -- OB-Oracle 查看对应角色拥有的数据库权限
   select PRIVILEGE from ROLE_SYS_PRIVS where ROLE='ROLE_NAME';

   ```

Previous

[为什么 Web 版 ODC 适用多用户场景](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000544172)

Next

[打开或测试连接报错 Connection refused](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000262286) ![有帮助](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) 咨询热线