GeoServer添加PostGIS存储失败：连接localhost:5432被拒绝

核心原因分析 #

本地psql能正常连接但GeoServer失败，大概率是网络连通性配置问题：

• 若GeoServer运行在Docker容器内，配置里的localhost指向的是GeoServer容器自身，而非宿主机上的PostgreSQL容器
• PostgreSQL可能未开启允许外部IP监听的配置

解决方案步骤 #

1. 修正GeoServer的数据库地址配置 #

• 如果GeoServer在宿主机运行：确认地址填localhost，同时核对端口、用户名、数据库名是否和psql命令中的参数完全一致
• 如果GeoServer在Docker容器运行：
  • 把localhost替换为宿主机的实际IP地址（比如192.168.1.100）
  • 更规范的做法是创建Docker自定义网络，将PostgreSQL和GeoServer容器加入同一网络，然后用PostgreSQL容器的名称作为数据库地址（比如postgres-container）

2. 配置PostgreSQL允许外部监听 #

进入PostgreSQL容器修改配置：

1. 执行命令进入容器：

   docker exec -it <你的PostgreSQL容器名> bash
   

2. 编辑postgresql.conf文件：

   vi /var/lib/postgresql/data/postgresql.conf
   

3. 找到listen_addresses配置项，将其从localhost改为*：

   listen_addresses = '*'
   

4. 重启PostgreSQL容器使配置生效：

   docker restart <你的PostgreSQL容器名>
   

3. 验证网络连通性 #

• 若GeoServer在宿主机：执行telnet localhost 5432，返回连接成功则网络正常
• 若GeoServer在Docker容器：进入GeoServer容器执行telnet <宿主机IP> 5432，确认能建立连接

4. 确认pg_hba.conf规则生效 #

你的pg_hba.conf最后一行host all all all scram-sha-256已允许所有IP连接，但需确保：

• PostgreSQL已重启，新规则生效
• postgres用户的密码是通过scram-sha-256加密的（可在PostgreSQL中执行ALTER USER postgres WITH PASSWORD '你的密码' ENCRYPTED WITH scram-sha-256;更新）

内容的提问来源于stack exchange，提问作者Devarshi Goswami