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

【操作系统和硬件信息】(查询命令: cat /etc/system-release, uname -a):
操作系统：openEuler 20.03 LTS (x86_64)
硬件信息：Linux localhost 4.19.90-2003.4.0.0036.oe1.x86_64 #1 SMP Mon Mar 23 19:06:43 UTC 2020 x86_64 x86_64 x86_64 GNU/Linux
【测试环境】(单机 / 1 主 x 备 x 级联备):单机
【被测功能】:JDBC 接口连接 openGauss 数据库功能
【测试类型】:接口功能
【数据库版本】(查询命令: gaussdb -V):openGauss 6.0.0
【预置条件】:
已安装 openGauss 数据库并启动
已配置 JDBC 连接所需的驱动包与配置文件
【操作步骤】(请填写详细的操作步骤):
编写 Java 程序，使用 JDBC 连接 openGauss 数据库，配置连接参数（IP 为 192.168.102.6，端口 26000，数据库名 postgres，用户名 gaussdb，密码 Gauss@123）
运行 Java 程序尝试建立数据库连接
【预期输出】:Java 程序成功连接 openGauss 数据库，控制台输出 “数据库连接成功”
【实际输出】:程序抛出异常，提示 “java.net.ConnectException: Connection refused: connect”，连接数据库失败
【原因分析】:
这个问题的根因：数据库服务未启动或监听端口配置错误，导致客户端连接请求被拒绝；也可能是服务器防火墙未开放数据库监听端口（默认 26000），阻止了外部连接请求。
问题推断过程：从报错信息 “Connection refused” 可判断是网络连接层面的问题，首先检查数据库服务状态（gs_om -t status），若服务未启动则启动服务；若服务已启动，再检查监听端口（netstat -tulpn | grep 26000）是否正常，最后排查防火墙规则（firewall-cmd --list-ports）是否开放 26000 端口。
还有哪些原因可能造成类似现象：客户端连接参数配置错误（如 IP、端口、数据库名错误）；数据库监听地址配置为localhost（仅允许本地连接），不支持远程连接；JDBC 驱动版本与数据库版本不兼容。
该问题是否有临时规避措施：若为服务未启动，可临时启动数据库服务（gs_om -t start）；若为端口未开放，可临时关闭防火墙（systemctl stop firewalld，生产环境不建议）或开放端口（firewall-cmd --zone=public --add-port=26000/tcp --permanent && firewall-cmd --reload）。
问题解决方案：
确认数据库服务处于启动状态：执行gs_om -t status，若服务未启动，执行gs_om -t start启动。
确认监听端口配置正确：检查postgresql.conf中listen_addresses是否为 “*”（允许所有 IP 连接），port是否为 26000；检查pg_hba.conf是否允许客户端 IP 的连接权限。
开放防火墙端口：执行firewall-cmd --zone=public --add-port=26000/tcp --permanent && firewall-cmd --reload。
验证 JDBC 驱动版本与数据库版本匹配，更换对应版本的驱动包。
预计修复问题时间：若为配置类问题，即时可修复；若为产品缺陷（如驱动不兼容），需根据产品迭代计划，预计在下次版本更新（如 6.0.1）中修复。
【日志信息】(请附上日志文件、截图、coredump 信息):
错误截图：![连接错误截图](此处可插入报错截图链接或描述，如显示 “java.net.ConnectException: Connection refused: connect” 的控制台输出)
数据库日志：pg_log目录下的日志文件中无明显连接成功记录，提示 “no connection attempt from client”
【测试代码】:
java
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class OpenGaussJdbcTest {
    public static void main(String[] args) {
        String url = "jdbc:postgresql://192.168.102.6:26000/postgres";
        String user = "gaussdb";
        String password = "Gauss@123";
        try {
            Connection conn = DriverManager.getConnection(url, user, password);
            System.out.println("数据库连接成功");
            conn.close();
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

openGauss/community

内容风险标识

评论 (0)

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

内容风险标识