部署Spring Boot 3到Google App Engine时遭遇StrategySelectionException错误

问题概述 #

将Spring Boot 3应用部署到Google App Engine（GAE）灵活环境后，遇到Hibernate方言解析错误，且application-mysql.properties配置未加载，但本地运行完全正常。通过Cloud Shell可正常连接目标MySQL实例。

核心错误 #

org.hibernate.boot.registry.selector.spi.StrategySelectionException: Unable to resolve name [org.hibernate.dialect.MySQL5InnoDBDialect] as strategy [org.hibernate.dialect.Dialect]

环境细节 #

GAE app.yaml 配置 #

runtime: java
env: flex
runtime_config:
  operating_system: "ubuntu22"
  runtime_version: "17" # 未指定时使用最新可用版本
env_variables:
  SPRING_PROFILES_ACTIVE: "gcp,mysql"
handlers:
  - url: /.*
    script: this field is required, but ignored
manual_scaling:
  instances: 1

部署命令 #

mvn clean package appengine:deploy -P cloud-gcp -DskipTests

数据库配置 #

application-mysql.properties配置未被加载，但将配置移至application.properties时，GAE可正常读取。配置内容（占位符已替换为真实值）：

spring.datasource.url=jdbc:mysql://google/<database_name>?cloudSqlInstance=<instance_connection_name>&socketFactory=com.google.cloud.sql.mysql.SocketFactory&user=<username>&password=<password>
spring.datasource.username=<username>
spring.datasource.password=<password>
spring.jpa.hibernate.ddl-auto=create
spring.liquibase.enabled=false

依赖配置 #

pom.xml中MySQL依赖：

<!-- MySQL database support -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

解决方案 #

1. 替换废弃的Hibernate方言 #

Spring Boot 3默认集成Hibernate 6.x，MySQL5InnoDBDialect已被移除，需替换为适配MySQL 8.0+的方言：
在application-mysql.properties中添加：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

若需适配旧版MySQL，可使用通用的MySQLDialect。

2. 修复application-mysql.properties加载问题 #

• 确认文件放置在src/main/resources根目录，路径无错误。
• 检查cloud-gcp Maven Profile是否正确激活，未覆盖SPRING_PROFILES_ACTIVE环境变量。
• 打包后验证Jar包内是否包含该文件：执行jar tf target/your-app.jar | grep application-mysql.properties。

3. 添加Cloud SQL Socket Factory依赖 #

当前依赖中缺少连接Cloud SQL必需的Socket Factory，需在pom.xml中添加：

<dependency>
    <groupId>com.google.cloud.sql</groupId>
    <artifactId>mysql-socket-factory</artifactId>
    <version>1.11.0</version> <!-- 建议使用最新稳定版 -->
</dependency>

4. 配置App Engine服务账号权限 #

确保GAE默认服务账号拥有Cloud SQL Client角色：

1. 进入Google Cloud控制台IAM页面
2. 找到格式为[项目ID]@appspot.gserviceaccount.com的服务账号
3. 为其添加Cloud SQL Client角色
4. 保存后重新部署应用

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