使用 JDBC 连接 openGauss 数据库时，控制台提示 “Connection refused: connect”，无法建立连接

1. 第一步：验证数据库服务是否正常启动（基础前提）
操作原因：连接拒绝的首要原因是数据库服务未启动，需先确认服务状态。
具体步骤：
登录 PuTTY（按文档步骤 3-4，使用 enp0s3 的 IP 和 root 账号登录，密码opengauss@123）；
切换至数据库操作系统用户omm：su - omm；
查看数据库服务状态：gs_om -t status --detail；
若状态显示 “Down”，执行启动命令：gs_om -t start，等待提示 “Successfully started all nodes”。
验证标准：执行gs_om -t status --detail后，“Node Status” 列显示 “Normal”，说明服务正常。
2. 第二步：检查数据库监听配置（文档中 “修改数据库监听地址” 环节易遗漏）
操作原因：若postgresql.conf中listen_addresses未设为 “*”，仅本地可连接，远程 JDBC 无法访问。
具体步骤：
在 PuTTY 中，切换omm用户后，进入数据库数据目录（文档中为/gaussdb/data/db1）：cd /gaussdb/data/db1；
查看当前监听配置：cat postgresql.conf | grep listen_addresses；
若显示listen_addresses = '127.0.0.1'（仅本地），执行修改命令：gs_guc set -I all -c "listen_addresses='*'"；
修改后重启数据库生效：gs_om -t restart。
验证标准：再次执行cat postgresql.conf | grep listen_addresses，显示listen_addresses = '*'。
3. 第三步：确认 pg_hba.conf 访问控制配置（文档中 “修改 pg_hba.conf 文件” 环节配置是否正确）
操作原因：pg_hba.conf控制客户端访问权限，若未添加 JDBC 客户端 IP 的允许规则，会拒绝连接。
具体步骤：
仍在/gaussdb/data/db1目录下，查看当前配置：cat pg_hba.conf | grep "host all all"；
若未找到host all all 0.0.0.0/0 sha256（允许所有 IP 使用 sha256 认证），执行添加命令：gs_guc set -N all -I all -h "host all all 0.0.0.0/0 sha256"；
重启数据库使配置生效：gs_om -t restart。
验证标准：执行cat pg_hba.conf | grep "host all all 0.0.0.0/0"，能看到新增的规则行。
4. 第四步：核对 JDBC 代码中的连接参数（文档中 “连接程序” 环节易出错）
操作原因：代码中 IP、端口、数据库名、账号密码错误是常见诱因，需与文档配置一致。
具体步骤：
打开openGaussdb_dlou2023.java文件，检查核心参数：
DB_URL：需改为文档中 enp0s3 的 IP（如192.168.56.3），端口26000，数据库名db_dlou2023，即"jdbc:postgresql://192.168.56.3:26000/db_dlou2023?ApplicationName=app1"；
USER：需为文档中创建的用户dlou2023，不可改为omm；
PASS：需为文档中设置的密码dlou@123，注意区分大小写；
重新编译代码（按文档步骤）：javac -encoding utf-8 -cp d:\Download\postgresql.jar openGaussdb_dlou2023.java；
重新执行代码：java -cp .;D:/Download/postgresql.jar openGaussdb_dlou2023。
验证标准：控制台输出 “连接数据库...” 后，继续显示 “实例化 Statement 对象...”，并打印 Student 表中的数据（学号、姓名等），无异常报错。
5. 第五步：排查网络防火墙（额外补充，文档未提及但易忽略）
操作原因：虚拟机防火墙可能拦截 26000 端口，导致 JDBC 连接超时或被拒。
具体步骤：
在 PuTTY 中，执行命令开放 26000 端口（针对 openEuler 系统）：
bash
firewall-cmd --add-port=26000/tcp --permanent  # 永久开放26000端口
firewall-cmd --reload  # 重新加载防火墙配置
在本地 Windows 系统中，打开 “命令提示符”，测试端口连通性：telnet 192.168.56.3 26000（需先开启 Windows 的 telnet 功能）。
验证标准：telnet命令执行后，窗口无 “连接失败” 提示，进入空白界面（表示端口可连通）。

openGauss/openGauss-connector-jdbc

内容风险标识

评论 (0)

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

内容风险标识