本地Docker运行Spring Boot应用连接GCP PostgreSQL失败求助

一、GCP PostgreSQL网络访问配置检查 #

• 确认GCP Cloud SQL实例的授权网络：进入控制台的数据库实例连接设置，将本地机器的公网IP添加到授权列表（测试阶段可临时允许0.0.0.0/0，生产环境务必删除）。
• 检查实例是否启用公共IP：若使用私有IP，本地Docker容器无法直接访问，测试阶段优先切换为公共IP；后续生产部署可改用VPC peering或Cloud VPN。

二、Spring应用连接配置验证 #

• 核对Docker容器内的数据库连接参数：
  • URL格式必须正确：jdbc:postgresql://[GCP_POSTGRES_PUBLIC_IP]:5432/[数据库名]
  • 确认用户名是GCP Cloud SQL中创建的数据库用户，密码匹配。
• 处理SSL连接要求：GCP Cloud SQL默认强制SSL，Spring配置需添加：

  spring.datasource.hikari.ssl-mode=REQUIRE
  spring.datasource.hikari.ssl=true
  

  若仅用于测试，可在GCP控制台临时关闭SSL强制。

三、Docker网络连通性测试 #

• 先在本地主机测试数据库连通性：

  psql -h [GCP_POSTGRES_PUBLIC_IP] -p 5432 -U [数据库用户名] -d [数据库名]
  

  若该命令无法连接，优先排查GCP数据库的网络配置或本地防火墙。
• 测试Docker容器内的网络访问：

  # 测试IP可达性
  docker run --rm alpine ping [GCP_POSTGRES_PUBLIC_IP]
  # 测试5432端口是否开放
  docker run --rm alpine telnet [GCP_POSTGRES_PUBLIC_IP] 5432
  

  若容器内无法访问，检查本地防火墙是否允许Docker容器对外访问5432端口，或是否有代理/VPN干扰。

四、GCP Kubernetes部署预准备 #

• 后续部署到K8s时，推荐使用Cloud SQL Auth Proxy替代公网IP直连（更安全）：
  • 以sidecar模式在Pod中运行Auth Proxy，Spring应用只需连接localhost:5432，由Proxy转发请求到GCP数据库。
  • 确保关联的GCP服务账号拥有Cloud SQL Client权限。

内容的提问来源于stack exchange，提问作者Karol Borecki