使用Bazel构建C++ gRPC服务器遇protoc工具链包查找失败

问题场景 #

使用C++ + Bazel开发gRPC服务器，项目包含proto/和src/目录，通过cpp_grpc_library编译proto文件时，出现以下错误：

ERROR: .../src/backend/proto/BUILD:3:17: Target '//proto:main-grpc_pb' depends on toolchain '@@toolchains_protocprotoc+toolchains_protoc_hub.linux_x86_64//:prebuilt_protoc_toolchain', which cannot be found: error loading package '@@toolchains_protocprotoc+toolchains_protoc_hub.linux_x86_64//': cannot load '@@rules_proto+//proto/private/rules:proto_toolchain_rule.bzl': no such file'

核心原因 #

1. 版本兼容性冲突：当前配置的依赖版本组合存在不匹配：
   • rules_proto 6.x重构了内部目录结构，移除了proto/private/rules路径，但rules_proto_grpc_cpp 5.0.1仍依赖该路径下的规则文件
   • protobuf 29.1与指定的protoc v27.1版本不一致，导致工具链匹配失败
2. 工具链注册缺失：未正确注册protoc工具链，Bazel无法识别对应的编译规则

解决办法 #

方案1：对齐兼容的依赖版本 #

修改MODULE.bazel，使用与rules_proto_grpc_cpp 5.0.1兼容的版本组合：

bazel_dep(name = "rules_proto_grpc_cpp", version = "5.0.1")
bazel_dep(name = "toolchains_protoc", version = "0.3.6")
# 使用与rules_proto_grpc_cpp 5.0.1兼容的rules_proto版本
bazel_dep(name = "rules_proto", version = "5.3.0-21.7")
# 对齐protoc版本v27.1
bazel_dep(name = "protobuf", version = "27.1")

protoc = use_extension("@toolchains_protoc//protoc:extensions.bzl", "protoc")
protoc.toolchain(
    google_protobuf = "com_google_protobuf",
    version = "v27.1",
)
# 注册protoc工具链
use_repo(protoc, "protoc_toolchains")
register_toolchains("@protoc_toolchains//:all")

方案2：升级到最新稳定版依赖 #

如果需要使用新版本组件，升级rules_proto_grpc_cpp到最新稳定版，并匹配对应依赖：

bazel_dep(name = "rules_proto_grpc_cpp", version = "6.0.0")
bazel_dep(name = "toolchains_protoc", version = "0.4.0")
bazel_dep(name = "rules_proto", version = "6.0.2")
bazel_dep(name = "protobuf", version = "29.1")
bazel_dep(name = "grpc", version = "1.62.0")

protoc = use_extension("@toolchains_protoc//protoc:extensions.bzl", "protoc")
protoc.toolchain(
    google_protobuf = "com_google_protobuf",
    version = "v29.1",
)

use_repo(protoc, "protoc_toolchains")
register_toolchains("@protoc_toolchains//:all")

额外验证步骤 #

1. 清理Bazel缓存：执行bazel clean --expunge，避免旧缓存干扰
2. 检查main.proto语法是否正确，无语法错误
3. 确认proto/BUILD中cpp_grpc_library配置参数完整，无遗漏

内容的提问来源于stack exchange，提问作者Inc.ace