Bazel构建C++项目出现protoc与Protobuf头文件版本不兼容报错

这个报错和系统安装的protoc无关，核心原因是Bazel依赖树中存在多个不兼容的Protobuf版本，生成.pb.h文件时调用的protoc版本，和C++编译阶段引用的Protobuf头文件版本不匹配，触发了Protobuf头文件内置的版本校验宏：

• Bazel构建默认不会调用系统路径下的protoc，所有编译工具都从自身依赖仓库拉取，因此卸载系统protoc无法解决问题。
• 你当前引入的gRPC v1.44.0默认绑定Protobuf 3.19.x版本，但rules_proto 4.0.0、TensorFlow开发镜像内置的Bazel工具链会拉取其他版本的Protobuf，且项目没有显式指定全局统一的Protobuf工具链，导致生成代码和编译依赖的版本错位。

1. 全局统一Protobuf版本 #

在WORKSPACE文件所有proto、gRPC相关依赖加载的最前面，显式声明和gRPC 1.44.0兼容的Protobuf版本（3.19.x），优先加载该版本以覆盖其他依赖默认拉取的不一致版本：

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

# 优先声明统一版本的Protobuf
http_archive(
    name = "com_google_protobuf",
    sha256 = "4a4465cdcf2620fd4ba3032a034d00b186d8b9a2a2a1d30919809b90be3a09d6",
    strip_prefix = "protobuf-3.19.4",
    urls = [
        "https://github.com/protocolbuffers/protobuf/archive/refs/tags/v3.19.4.tar.gz",
    ],
)

# 后续保留原有的rules_proto、gRPC加载逻辑
http_archive(
    name = "rules_proto",
    sha256 = "66bfdf8782796239d3875d37e7de19b1d94301e8972b3cbd2446b332429b4df1",
    strip_prefix = "rules_proto-4.0.0",
    urls = [
        "https://mirror.bazel.build/github.com/bazelbuild/rules_proto/archive/refs/tags/4.0.0.tar.gz",
        "https://github.com/bazelbuild/rules_proto/archive/refs/tags/4.0.0.tar.gz",
    ],
)
load("@rules_proto//proto:repositories.bzl", "rules_proto_dependencies", "rules_proto_toolchains")
rules_proto_dependencies()
rules_proto_toolchains()

http_archive(
    name = "com_github_grpc_grpc",
    urls = [
        "https://github.com/grpc/grpc/archive/refs/tags/v1.44.0.tar.gz",
    ],
    sha256 = "8c05641b9f91cbc92f51cc4a5b3a226788d7a63f20af4ca7aaca50d92cc94a0d",
    strip_prefix = "grpc-1.44.0",
)
load("@com_github_grpc_grpc//bazel:grpc_deps.bzl", "grpc_deps")
grpc_deps()
load("@com_github_grpc_grpc//bazel:grpc_extra_deps.bzl", "grpc_extra_deps")
grpc_extra_deps()

2. 强制指定C++ Proto编译工具链 #

在项目根目录的.bazelrc文件中添加如下配置，避免Bazel自动选到TensorFlow镜像内置的不兼容Proto工具链：

build --proto_toolchain_for_cc=@com_google_protobuf//:cc_toolchain

3. 清理缓存后重新构建 #

旧版本protoc生成的.pb.h文件会残留在Bazel缓存中，必须执行全量清理后才能用统一版本的工具链重新生成：

bazel clean --expunge

清理完成后重新执行构建命令即可。

兜底排查 #

如果上述操作完成后仍报错，检查项目中引入的TensorFlow相关依赖是否自带了独立版本的Protobuf头文件，如果存在该情况，需要通过依赖排除规则去掉第三方依赖自带的Protobuf，统一依赖全局声明的com_google_protobuf版本。

内容的提问来源于stack exchange，提问作者slai-nick