升级Cloud Dataflow模板（Java SDK）Beam版本时的依赖冲突

问题核心原因 #

你遇到的报错逻辑看似矛盾，实际是版本兼容性问题：旧版google-api-services-storage（v1-rev20181013-1.27.0）是基于google-api-client 1.x开发的，它的版本校验逻辑只针对1.x系列设计——当检测到2.x版本时，会误判为不符合最低1.15的要求（本质是2.x和1.x是不兼容的大版本，并非数字大小问题）。而google-api-client 2.0.0是Beam 2.43.0的依赖组件自动引入的。

解决方案 #

方案1：升级google-api-services-storage到兼容2.x的版本

替换pom中的storage依赖为适配google-api-client 2.x的版本，比如匹配Beam 2.43.0的稳定版：

<dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-storage</artifactId>
    <!-- 示例为兼容2.x的版本，可根据Beam版本调整 -->
    <version>v1-rev20230908-2.0.0</version>
</dependency>

这个方案从根源上解决版本不兼容问题，推荐优先尝试。

方案2：强制锁定google-api-client为1.x稳定版本

如果升级storage库会触发其他代码报错，可通过Maven的dependencyManagement强制指定1.x版本，覆盖Beam引入的2.0.0：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.google.api-client</groupId>
            <artifactId>google-api-client</artifactId>
            <!-- 选择1.x的高稳定版本，比如1.34.1 -->
            <version>1.34.1</version>
        </dependency>
    </dependencies>
</dependencyManagement>

先执行mvn dependency:tree确认没有其他依赖冲突，再重新部署。

额外排查步骤

• 用mvn dependency:tree命令查看完整依赖树，确认哪个组件引入了google-api-client 2.0.0（大概率是Beam的google-cloud-platform相关模块）。
• 若之前声明更高版本的google-api-client报错，是因为2.x版本和旧版storage库的API不兼容，要么升级storage库，要么回退到1.x版本。

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