预检查入阶段Bazel Build报错：IdentityDefinition方法未定义

问题场景 #

本地运行应用及执行bazel clean && bazel build均无构建问题，但预检查入时触发如下Bazel Build报错：

bazel-build | # Execution platform: //tools/build/bazel/sfdc/java:host_ecj
bazel-build | /cix/src/client/app/main/core/delete/test/func/java/src/common/delete/physical/entity/PhysicalDeleteEntitiesTestSuite.java:302: error: The method customEntityType() is undefined for the type IdentityDefinition
bazel-build |   !schema.identity().customEntityType().isPlatformSchema();

排查与解决方向 #

• 核对本地与CI的Bazel版本：预检查入的CI环境可能使用了和本地不同的Bazel版本，部分依赖解析逻辑存在版本差异。执行bazel version对比两边版本号，若不一致，在本地切换到CI使用的版本重新构建验证。
• 检查依赖可见性配置：确认IdentityDefinition所在的Bazel target是否在测试目标PhysicalDeleteEntitiesTestSuite的可见性范围内。本地可能因工作区配置宽松绕过了检查，而CI严格执行规则，需确保测试目标的BUILD文件正确声明依赖，且目标的visibility设置允许测试代码访问。
• 强制刷新CI依赖缓存：CI环境可能留存了旧的依赖缓存，导致拉取的IdentityDefinition类不是最新版本。在预检查入流程中添加bazel clean --expunge命令，彻底清理缓存后重新构建。
• 验证测试代码的依赖来源：检查测试代码是否误引用了旧版本的IdentityDefinition类。本地IDE可能优先加载最新代码，而CI中Bazel可能从其他路径拉取了旧类文件，可通过bazel query查看CI环境中测试目标依赖的IdentityDefinition来源，对比本地路径是否一致。
• 对齐本地与CI的执行平台：报错显示执行平台为//tools/build/bazel/sfdc/java:host_ecj，本地可能使用了不同平台。尝试在本地执行bazel build --host_platform=//tools/build/bazel/sfdc/java:host_ecj，看是否能复现问题，定位平台相关的依赖解析异常。

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