如何解决GAE弹性自定义环境连接Cloud SQL Postgres失败问题

我帮你梳理下当前配置里的问题，一步步来修复这个连接故障：

1. 让db.properties读取环境变量而非硬编码值 #

你现在的db.properties写死了本地地址127.0.0.1，但在App Engine Flex环境中，Cloud SQL的连接信息是通过环境变量传递的。得修改配置，让数据源加载这些动态值：

如果你的应用用了Spring这类框架，可以直接在db.properties里用占位符：

dataSourceClassName = org.postgresql.ds.PGSimpleDataSource
dataSource.databaseName = ${POSTGRES_DB}
dataSource.user = ${POSTGRES_USER}
dataSource.password = ${POSTGRES_PASSWORD}
# Unix Socket连接不需要portNumber，直接注释掉
# dataSource.portNumber = 5432
# 用Socket工厂配置替代serverName
dataSource.socketFactory = org.postgresql.core.SocketFactory
dataSource.socketFactoryArg = ${POSTGRES_HOST}
maximumPoolSize = 5

要是没用到框架自动处理占位符，就在代码里手动读取环境变量覆盖配置：

Properties dbProps = new Properties();
try (InputStream input = getClass().getClassLoader().getResourceAsStream("db.properties")) {
    dbProps.load(input);
    // 替换为环境变量中的Socket路径
    dbProps.setProperty("dataSource.socketFactoryArg", System.getenv("POSTGRES_HOST"));
    // 移除无用的TCP连接配置
    dbProps.remove("dataSource.serverName");
    dbProps.remove("dataSource.portNumber");
    // 初始化数据源逻辑...
} catch (IOException e) {
    e.printStackTrace();
}

2. 调整PostgreSQL数据源适配Unix Socket连接 #

PGSimpleDataSource默认走TCP连接，但App Engine Flex里推荐用Unix Socket（也就是你POSTGRES_HOST里的/cloudsql/<instance name>路径）。上面的配置已经通过socketFactory实现了这个适配，这样数据源就能正确识别Unix Socket路径了。

3. 修正Dockerfile的端口配置 #

你的Dockerfile暴露了5432端口，这完全没必要——Cloud SQL是外部服务，你的应用容器不需要监听这个端口，只需要保留Web服务的8080端口即可：

# 只暴露Web服务端口
EXPOSE 8080
ENTRYPOINT ["mvn", "jetty:run"]

4. 确保App Engine服务账号有Cloud SQL访问权限 #

登录Google Cloud控制台，检查你的App Engine默认服务账号（格式一般是[你的项目ID]@appspot.gserviceaccount.com）是否拥有Cloud SQL Client角色：

• 进入IAM & Admin > IAM页面
• 找到对应服务账号，点击编辑按钮
• 添加角色：Cloud SQL > Cloud SQL Client
• 保存更改

5. 验证app.yaml的Cloud SQL配置 #

确认beta_settings里的cloud_sql_instances是你的Cloud SQL实例的完整连接名（格式为[项目ID]:[区域]:[实例名]），比如：

beta_settings:
  cloud_sql_instances: my-gcp-project:us-central1:my-postgres-instance

不需要加=tcp:5432后缀，因为我们用的是Unix Socket连接。

做完这些调整后，重新部署应用，应该就能成功连接到Cloud SQL了。

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