0

0

解决Bazel Java测试中Protobuf间接依赖错误的指南

花韻仙語

花韻仙語

发布时间:2025-10-31 10:39:28

|

882人浏览过

|

来源于php中文网

原创

解决Bazel Java测试中Protobuf间接依赖错误的指南

本文旨在解决bazel构建系统中,java_test_suite在使用protobuf类型(如com.google.protobuf.timestamp)时遇到的“using type from an indirect dependency”错误。核心在于理解protobuf的proto_library与java_proto_library之间的区别,并正确配置依赖,确保java测试直接依赖于protobuf生成的java代码库,而非原始的.proto定义。

理解Bazel的严格依赖与Protobuf类型

在使用Bazel构建Java项目时,我们经常会遇到“Using type X from an indirect dependency”的错误。这通常是Bazel严格依赖(Strict Deps)检查的结果,它要求所有直接使用的类型都必须通过直接依赖显式声明。对于Protobuf类型,如com.google.protobuf.Timestamp,这个错误尤其常见,因为Protobuf的定义和其对应的Java类是分开生成的。

原始的timestamp_proto(通常由proto_library规则定义)仅仅包含了Protobuf的.proto文件定义。它本身并不直接提供Java类型。要使用这些Protobuf定义的Java类,我们需要一个中间步骤:通过java_proto_library规则将.proto文件编译成Java源代码,并打包成一个Java库。

当java_test_suite直接依赖于@com_google_protobuf//:timestamp_proto时,它实际上只看到了Protobuf的原始定义。虽然在某些情况下,这些原始定义可能间接拉取了包含Java类的库,但Bazel的严格依赖机制会认为com.google.protobuf.Timestamp这个Java类型并非来自timestamp_proto的直接输出,从而抛出间接依赖错误。

错误的依赖配置示例

考虑以下java_test_suite配置,它试图直接依赖Protobuf的timestamp_proto:

立即学习Java免费学习笔记(深入)”;

# BUILD文件片段
java_test_suite(
    name = "all-tests",
    srcs = glob(["src/test/java/**/*.java"]),
    runner = "junit5",
    test_suffixes = ["Test.java"],
    runtime_deps = JUNIT5_DEPS,
    deps = [
        ":mylib",
        "@com_google_protobuf//:timestamp_proto", # 错误:直接依赖proto_library
        artifact("org.junit.jupiter:junit-jupiter-api"),
        artifact("org.junit.jupiter:junit-jupiter-params"),
    ] + deps,
)

当CustomTest.java中包含import com.google.protobuf.Timestamp;并尝试使用该类型时,Bazel会报错:

src/test/java/com/x/CustomTest.java:75: error: [strict] Using type com.google.protobuf.Timestamp from an indirect dependency (TOOL_INFO: "@com_google_protobuf//:timestamp_proto wrapped in java_proto_library").

错误信息中TOOL_INFO: "@com_google_protobuf//:timestamp_proto wrapped in java_proto_library"这一部分是关键,它暗示了timestamp_proto需要被java_proto_library包装才能提供Java类型。

正确的解决方案

解决此问题的核心在于引入一个java_proto_library规则,它将timestamp_proto编译为可供Java代码使用的库。然后,java_test_suite应该依赖于这个新创建的java_proto_library目标。

PaperAiBye
PaperAiBye

支持近30多种语言降ai降重,并且支持多种语言免费测句子的ai率,支持英文aigc报告等

下载

步骤一:定义java_proto_library目标

在您的BUILD文件中,定义一个java_proto_library规则。这个规则将负责从@com_google_protobuf//:timestamp_proto生成Java类。

# 在您的BUILD文件中添加此规则
java_proto_library(
  name = "timestamp_java_proto",
  deps = ["@com_google_protobuf//:timestamp_proto"],
)

这里,timestamp_java_proto是我们创建的新目标,它依赖于Protobuf的原始timestamp_proto定义。当这个目标被构建时,它会生成包含com.google.protobuf.Timestamp等Java类的库。

步骤二:更新java_test_suite依赖

现在,将java_test_suite的deps从@com_google_protobuf//:timestamp_proto改为新创建的//:timestamp_java_proto。

# 更新后的BUILD文件片段
java_test_suite(
    name = "all-tests",
    srcs = glob(["src/test/java/**/*.java"]),
    runner = "junit5",
    test_suffixes = ["Test.java"],
    runtime_deps = JUNIT5_DEPS,
    deps = [
        ":mylib",
        "//:timestamp_java_proto", # 正确:依赖java_proto_library
        artifact("org.junit.jupiter:junit-jupiter-api"),
        artifact("org.junit.jupiter:junit-jupiter-params"),
    ] + deps,
)

通过这个修改,java_test_suite现在直接依赖于一个提供com.google.protobuf.Timestamp Java类型的库,满足了Bazel的严格依赖要求。

关于buildozer命令的注意事项

在问题描述中,提到了buildozer 'add deps @com_google_protobuf//:timestamp_proto' //:src/test/java/com/x/CustomTest命令失败,并提示rule 'src/test/java/com/x/CustomTest' not found。这是因为buildozer命令是用来修改Bazel规则的,而//:src/test/java/com/x/CustomTest指向的是一个源文件路径,而非一个Bazel规则目标。依赖关系应该添加到定义这些源文件的Bazel规则(例如java_test_suite或java_library)上,而不是源文件本身。理解Bazel的目标和源文件之间的区别对于正确使用buildozer至关重要。

总结

当在Bazel的Java项目中遇到Protobuf类型相关的“Using type from an indirect dependency”错误时,请记住以下几点:

  1. proto_library vs. java_proto_library: proto_library仅定义.proto文件,而java_proto_library负责将其编译为Java类。
  2. 直接依赖: 您的Java代码(包括测试)需要直接依赖于提供Java类的java_proto_library目标。
  3. 创建中间目标: 如果您直接使用的Protobuf定义是proto_library类型,请为其创建一个java_proto_library包装目标。

遵循这些原则,可以有效解决Bazel严格依赖下Protobuf Java类型的引用问题,确保构建的清晰性和正确性。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

834

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

739

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

735

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

399

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16926

2023.08.03

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

27

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.6万人学习

C# 教程
C# 教程

共94课时 | 6.9万人学习

Java 教程
Java 教程

共578课时 | 46.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号