Spring Boot集成GCP多服务出现NoClassDefFoundError及后续异常求助

看起来你在整合GCP BigQuery、PubSub和Dataflow/Beam的过程中踩了依赖版本冲突的坑，咱们一步步来解决这两个错误：

问题根源拆解 #

你碰到的两个NoClassDefFoundError本质都是依赖问题：

1. 第一个错误缺失com.google.api.gax.grpc.GrpcStatusCode：这是因为Spring Cloud GCP PubSub starter和Beam依赖的google-api-gax-grpc库版本不兼容，导致类找不到。
2. 第二个错误缺失com.google.api.services.cloudresourcemanager.CloudResourceManager$Builder：Dataflow Runner需要这个类来验证GCP临时存储位置的权限，而你的项目里没引入对应的Cloud Resource Manager客户端库。

具体修复方案 #

1. 修复GrpcStatusCode缺失问题 #

在你的pom.xml的<dependencies>节点里添加显式的gax-grpc依赖，同时统一GCP PubSub客户端版本，避免冲突：

<!-- 显式引入gax-grpc，解决GrpcStatusCode找不到的问题 -->
<dependency>
    <groupId>com.google.api</groupId>
    <artifactId>gax-grpc</artifactId>
    <version>1.3.0</version>
</dependency>
<!-- 统一PubSub客户端版本，和Spring Cloud GCP兼容 -->
<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-pubsub</artifactId>
    <version>1.28.0</version>
</dependency>

2. 修复CloudResourceManager$Builder缺失问题 #

Dataflow需要Cloud Resource Manager来管理GCP资源，所以添加对应的客户端依赖到<dependencies>：

<!-- 添加Cloud Resource Manager客户端，解决Dataflow的资源验证问题 -->
<dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-cloudresourcemanager</artifactId>
    <version>v1-rev20240313-2.0.0</version>
</dependency>

3. 优化依赖管理，从根源减少冲突 #

建议在你的<dependencyManagement>里引入GCP和Beam的BOM（物料清单），自动统一所有相关依赖的版本，不用手动一个个指定：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-gcp-dependencies</artifactId>
            <version>1.0.0.M2</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <!-- 引入Beam BOM，统一所有Beam组件版本 -->
        <dependency>
            <groupId>org.apache.beam</groupId>
            <artifactId>beam-sdks-java-bom</artifactId>
            <version>2.2.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <!-- 引入GCP客户端BOM，统一所有GCP SDK版本 -->
        <dependency>
            <groupId>com.google.cloud</groupId>
            <artifactId>libraries-bom</artifactId>
            <version>26.25.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

4. 清理缓存重新构建 #

最后执行Maven命令清理旧的依赖缓存，重新拉取正确的版本：

mvn clean install -U

额外小贴士 #

你当前用的Spring Boot 2.0.0.RC1和Spring Cloud GCP 1.0.0.M2都是早期预览版，兼容性问题比较多。如果可以的话，建议升级到更稳定的版本，比如Spring Boot 2.7.x搭配Spring Cloud GCP 3.4.x，能减少很多奇怪的依赖冲突。

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