连接 openGauss 数据库时，出现 Connection refused 错误

连接 openGauss 数据库时出现 Connection refused 错误
在单机环境下，使用 JDBC 接口连接 openGauss 数据库时遇到连接失败问题。
 
环境信息
 
- 操作系统：openEuler 20.03 LTS (x86_64)

- 硬件信息：Linux localhost 4.19.90-2003.4.0.0036.oe1.x86_64

- 数据库版本：openGauss 6.0.0

- 测试环境：单机

- 测试类型：接口功能测试
 
问题详情
 
预置条件：
已成功安装 openGauss 数据库并启动服务，同时配置好了 JDBC 驱动包和相关配置文件。
 
操作步骤：
 
1. 编写 Java 程序，通过 JDBC 连接 openGauss 数据库。

2. 配置连接参数：IP 地址  192.168.102.6 ，端口  26000 ，数据库名  postgres ，用户名  gaussdb ，密码  Gauss@123 。

3. 运行 Java 程序尝试建立数据库连接。
 
预期结果：
Java 程序能够成功连接到 openGauss 数据库，控制台输出"数据库连接成功"。
 
实际结果：
程序运行后抛出  java.net.ConnectException: Connection refused: connect  异常，数据库连接失败。
 
原因分析
 
这个问题的根本原因是网络连接层面被拒绝，可能包括：
 
- 数据库服务未启动

- 监听端口配置错误

- 服务器防火墙阻止了端口  26000  的连接
 
排查思路：
从  Connection refused  报错来看，这是典型的网络层面问题。排查应从外到内：
 
1. 检查服务状态：确认数据库服务是否已启动。

2. 检查端口监听：确认数据库是否在端口  26000  上正常监听。

3. 检查防火墙：确认防火墙规则是否允许端口  26000  的流量通过。
 
其他可能原因：
 
- 连接参数（IP、端口、库名）配置错误

- 数据库配置为仅允许本地连接（ listen_addresses = 'localhost' ）

- JDBC 驱动版本与数据库版本不兼容
 
解决方案：
 
1. 启动数据库服务：执行  gs_om -t start  确保服务已启动。

2. 配置监听地址：修改  postgresql.conf ，确保  listen_addresses = '*'  且  port = 26000 。

3. 配置访问权限：修改  pg_hba.conf ，添加允许客户端 IP 连接的规则。

4. 开放防火墙端口：执行  firewall-cmd --zone=public --add-port=26000/tcp --permanent  并  firewall-cmd --reload 。

5. 验证驱动版本：确保使用的 JDBC 驱动版本与 openGauss 6.0.0 兼容。
 
临时规避措施：
可临时关闭防火墙（生产环境不推荐）或启动数据库服务来应急。
 
日志与代码
 
错误日志：
 
- 应用程序控制台输出  java.net.ConnectException: Connection refused: connect  异常栈。

- 数据库日志（pg_log）中没有客户端连接记录，可能提示"no connection attempt from client"。
 
测试代码：
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class GaussConnectionTester {
    public static void main(String[] args) {
        // 数据库连接信息
        String dbUrl = "jdbc:postgresql://192.168.102.6:26000/postgres";
        String dbUser = "gaussdb";
        String dbPassword = "Gauss@123";

Connection connection = null;
        try {
            // 尝试建立数据库连接
            connection = DriverManager.getConnection(dbUrl, dbUser, dbPassword);
            
            // 如果连接成功，打印成功信息
            if (connection != null) {
                System.out.println("数据库连接成功");
            }
        } catch (SQLException e) {
            // 如果连接失败，打印异常信息
            System.err.println("数据库连接失败");
            e.printStackTrace();
        } finally {
            // 确保连接资源被关闭
            if (connection != null) {
                try {
                    connection.close();
                } catch (SQLException e) {
                    e.printStackTrace();
                }
            }
        }
    }
}

openGauss/community

内容风险标识

评论 (0)

openGauss/community .gitee-modal { width: 500px !important; }

内容风险标识