Bazel引入truth-proto-extension后Guava JRE版被降级报编译错误的解决问询

问题场景说明 #

在Bazel工作区引入com.google.truth.extensions:truth-proto-extension:1.1依赖后，依赖树的版本仲裁逻辑会优先采用Truth传递依赖的Guava Android版本，完全覆盖项目原本使用的com.google.guava:guava:28.2-jre版本提供的类，触发典型编译报错：

import static com.google.common.collect.ImmutableMap.toImmutableMap;
^
  symbol:   static toImmutableMap
  location: class ImmutableMap
java/com/google/fhir/protogen/ProtoGenerator.java:316: error: cannot find symbol
            .collect(toImmutableMap(def -> def.getId().getValue(), def -> def));
                     ^
  symbol:   method toImmutableMap((def)->def[...]lue(),(def)->def)
  location: class ProtoGenerator

对应的官方说明原文：

注意事项：Truth依赖的是Guava的「Android」版本，该版本是「JRE」版本的子集。如果你的项目使用JRE版本，需要注意构建系统可能会自动选择Android版本替代，此时就可能出现「找不到符号」类的错误，通常最简单的修复方式是直接添加对最新JRE版本Guava的显式依赖。

核心疑问的明确答复 #

文档提到的「添加最新JRE版Guava」的修复方式，并非仅指添加com.google.guava:guava:28.2-jre这个固定Maven坐标。

• 28.2-jre只是你项目原本在使用的Guava版本，并非文档强制要求的固定版本
• 该表述的核心要求是：通过显式声明的方式，将依赖树中的Guava版本从裁剪后的Android变体，切换回包含完整JRE方法集的JRE变体，解决方法缺失的编译问题
• 这里提到的「最新JRE版本」指的是适配项目当前编译环境、满足代码功能依赖的JRE线Guava版本，既可以沿用项目原本使用的28.2-jre，也可以选择更高的、经过项目兼容性验证的JRE版Guava版本，无强制的版本号要求。

受限时的次优修复方案 #

如果因为项目版本锁定规则、依赖管控要求等限制，无法直接通过新增显式JRE Guava依赖实现版本覆盖，可按以下优先级执行修复：

• 对引入的truth-proto-extension依赖增加传递依赖排除规则，移除其自带的Android变体Guava传递依赖，将项目原本使用的28.2-jre版本Guava设置为全局唯一的Guava依赖来源
• 如果项目不支持单个依赖的排除配置，可在Bazel的仓库映射配置中增加Guava坐标重定向规则，强制将所有传递依赖中匹配到的Android变体Guava坐标，重定向指向项目已声明的JRE版Guava资源，从根源上阻断Android版Guava被拉取到项目依赖树中
• 注意：不建议通过修改业务代码、手动替换toImmutableMap等缺失方法实现的方式绕开报错，这类临时修改会留下后续其他JRE专属Guava方法被裁剪的隐性隐患。

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