SpringBoot配置中如何指定CloudSQL Postgres实例名称？

首先，你当前的配置存在几个关键问题需要修正：

• 原JDBC URL使用的是MySQL前缀jdbc:mysql://，Postgres必须改为jdbc:postgresql://
• CloudSQL的实例信息不能通过单独的app.datasource.instance属性配置，HikariDataSource不识别这个参数，必须整合到JDBC URL中或使用Spring Cloud GCP专用starter

以下是两种可行的解决方案：

方案一：使用CloudSQL代理（推荐，安全合规） #

这是Google官方推荐的连接方式，无需暴露实例公网IP：

1. 修正JDBC URL格式
   URL需要包含SocketFactory参数和CloudSQL实例连接名（格式为项目ID:区域:实例名，比如my-gcp-project:us-central1:my-postgres-instance）：

   app.datasource.url=jdbc:postgresql://localhost:5432/你的数据库名?socketFactory=com.google.cloud.sql.postgres.SocketFactory&cloudSqlInstance=你的实例连接名
   app.datasource.username=你的Postgres用户名（默认是postgres）
   app.datasource.password=你的数据库密码
   app.datasource.hikari.maximum-pool-size=30
   

   注意：原配置中的pool-size不是Hikari的标准属性，需改为hikari.maximum-pool-size

2. 添加CloudSQL SocketFactory依赖
   在构建文件中加入Postgres专用的SocketFactory依赖：

   • Maven：

     <dependency>
         <groupId>com.google.cloud.sql</groupId>
         <artifactId>postgres-socket-factory</artifactId>
         <version>1.15.0</version>
     </dependency>
     

   • Gradle：

     implementation 'com.google.cloud.sql:postgres-socket-factory:1.15.0'
     

3. 启动CloudSQL代理
   按照Google文档启动代理（本地开发用cloud-sql-proxy命令，部署到GCP环境可自动集成），代理会监听localhost:5432并转发请求到CloudSQL实例。

方案二：直接公网IP连接（仅测试用，不推荐生产） #

如果只是临时测试，可开启CloudSQL实例的公网访问权限，用公网IP直接连接：

app.datasource.url=jdbc:postgresql://实例公网IP:5432/你的数据库名
app.datasource.username=postgres
app.datasource.password=你的数据库密码
app.datasource.hikari.maximum-pool-size=30

注意：生产环境不建议使用这种方式，存在安全风险。

方案三：使用Spring Cloud GCP Starter（简化配置） #

如果项目基于Spring Cloud，可使用Google提供的starter自动配置数据源，无需手动处理SocketFactory：

1. 添加Starter依赖

   • Maven：

     <dependency>
         <groupId>com.google.cloud</groupId>
         <artifactId>spring-cloud-gcp-starter-sql-postgresql</artifactId>
     </dependency>
     

   • Gradle：

     implementation 'com.google.cloud:spring-cloud-gcp-starter-sql-postgresql'
     

2. 简化配置文件

   spring.cloud.gcp.sql.instance-connection-name=项目ID:区域:实例名
   spring.cloud.gcp.sql.database-name=你的数据库名
   spring.datasource.username=postgres
   spring.datasource.password=你的数据库密码
   spring.datasource.hikari.maximum-pool-size=30
   

   这种方式下，Spring会自动配置数据源和SocketFactory，无需自定义dataSource()方法（若要保留app.datasource前缀，可调整配置绑定规则）。

最后，记得删除无效的app.datasource.instance配置项，它不会被Hikari识别。

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