部署在Google Cloud Function的Spring Cloud Function无法连接Cloud SQL

1. 修复Hibernate方言配置 #

日志提示的hibernate.dialect未设置会导致JPA无法适配MySQL特性，直接干扰数据库连接逻辑。

• 在Spring配置文件（application.properties/application.yml）中明确指定对应MySQL版本的方言：

  # MySQL 8.x版本用这个
  spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
  # MySQL 5.x版本替换为：org.hibernate.dialect.MySQL5Dialect
  

2. 配置Cloud SQL专用连接方式 #

本地用公网IP能连接，但Cloud Functions部署后必须使用GCP内部合规的连接方式，不能直接复用本地公网IP配置：

• 优先使用Cloud SQL Auth Proxy：部署时通过环境变量传递代理连接串，同时确保项目引入Socket Factory依赖。
  部署命令示例：

  gcloud functions deploy YOUR_FUNCTION_NAME \
    --runtime java17 \
    --trigger-http \
    --set-env-vars SPRING_DATASOURCE_URL="jdbc:mysql://localhost:3306/YOUR_DB_NAME?socketFactory=com.google.cloud.sql.mysql.SocketFactory&cloudSqlInstance=YOUR_PROJECT_ID:YOUR_REGION:YOUR_INSTANCE_NAME" \
    --set-env-vars SPRING_DATASOURCE_USERNAME=YOUR_DB_USER \
    --set-env-vars SPRING_DATASOURCE_PASSWORD=YOUR_DB_PASSWORD \
    --service-account YOUR_SERVICE_ACCOUNT_EMAIL
  

  Maven依赖添加：

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

• 禁用公网IP直接连接：Cloud Functions运行在GCP内部网络，直接访问Cloud SQL公网IP可能被防火墙/VPC规则拦截，且安全性远低于Auth Proxy方案。

3. 补全服务账号关键权限 #

现有Cloud Functions Developer和Cloud SQL Editor权限不足以支持Auth Proxy连接，需添加Cloud SQL Client角色：

• 进入GCP控制台IAM页面，找到目标服务账号，添加roles/cloudsql.client角色。

4. 确保配置环境隔离 #

避免本地硬编码配置覆盖部署环境变量：

• 不要在代码或配置文件中固定写死公网IP，全部通过环境变量传递SPRING_DATASOURCE_URL等核心配置，保证部署时使用的是Auth Proxy连接串。

5. 排查网络规则（可选） #

如果使用VPC私有网络连接：

• 确认Cloud SQL实例的私有IP配置正确，且Cloud Functions与Cloud SQL处于同一VPC网络，或已配置VPC连接器。

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