Spring Boot整合GCP Spanner+Hibernate启动时entityManagerFactory创建失败求助

这个错误本质是gRPC版本不兼容导致的接口实现缺失问题——Spring Boot 3.2.1自带的gRPC版本与GCP Spanner依赖的gRPC版本存在冲突，使得NettyTransportFactory无法匹配ClientTransportFactory的接口规范。以下是针对性的解决步骤：

1. 排查并统一gRPC依赖版本 #

• 执行依赖树命令查看冲突：
  • Maven：mvn dependency:tree
  • Gradle：./gradlew dependencies
• 重点关注grpc-netty-shaded和grpc-core的版本，确保所有模块引入的这两个依赖版本完全一致。

2. 使用GCP BOM管理版本适配 #

不要单独调整单个Spanner依赖版本，通过GCP官方BOM统一管理所有GCP组件版本，确保与Spring Boot 3.2.1兼容：

<!-- 在pom.xml的dependencyManagement中添加 -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>spring-cloud-gcp-dependencies</artifactId>
      <version>4.8.0</version> <!-- 该版本适配Spring Boot 3.2.x -->
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

之后移除google-cloud-spanner-hibernate-dialect和google-cloud-spanner-jdbc的手动版本号，由BOM自动匹配兼容版本。

3. 手动排除冲突依赖并指定兼容版本 #

如果依赖树仍显示版本冲突，在Spanner依赖中排除旧版gRPC，再手动引入与Spring Boot匹配的版本：

<!-- 排除Spanner依赖中的冲突gRPC -->
<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-spanner-jdbc</artifactId>
  <exclusions>
    <exclusion>
      <groupId>io.grpc</groupId>
      <artifactId>grpc-netty-shaded</artifactId>
    </exclusion>
    <exclusion>
      <groupId>io.grpc</groupId>
      <artifactId>grpc-core</artifactId>
    </exclusion>
  </exclusions>
</dependency>

<!-- 引入与Spring Boot 3.2.1兼容的gRPC版本 -->
<dependency>
  <groupId>io.grpc</groupId>
  <artifactId>grpc-netty-shaded</artifactId>
  <version>1.59.0</version>
</dependency>
<dependency>
  <groupId>io.grpc</groupId>
  <artifactId>grpc-core</artifactId>
  <version>1.59.0</version>
</dependency>

4. 验证Hibernate方言配置 #

确保配置文件中指定正确的Spanner方言：

# application.properties
spring.jpa.properties.hibernate.dialect=com.google.cloud.spanner.hibernate.SpannerDialect

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