如何解决Python中Protobuf重复符号引发的TypeError异常？

问题根源 #

Protobuf的全局DescriptorPool不允许同一个包下存在同名的消息类型——无论这些定义来自哪个.proto文件。当你导入第二个生成的Python文件时，它会尝试将重复的消息描述符加入全局池，直接触发冲突错误。

可行解决方案 #

方案1：修改包名（推荐） #

给两个.proto文件设置不同的包名，从根源避免冲突：

// grpc_interface_1.proto
syntax = "proto3";
package core.grpc_interface.v1; // 修改包名

message Message1 {
  string id = 1;
}

// grpc_interface_2.proto
syntax = "proto3";
package core.grpc_interface.v2; // 设置不同包名

message Message1 {
  string id = 1;
}

重新编译后，两个模块的消息类型属于不同命名空间，导入和使用都不会冲突：

import grpc_interface_1_pb2 as pb1
import grpc_interface_2_pb2 as pb2

# 区分使用两个同名消息
msg1 = pb1.Message1(id="test1")
msg2 = pb2.Message1(id="test2")

方案2：使用独立的DescriptorPool（进阶） #

如果无法修改.proto文件，可以为第二个模块创建独立的描述符池，绕过全局池的限制：

1. 编译时生成描述符文件（添加--descriptor_set_out参数）：

# 编译第一个文件并生成描述符
python -m grpc_tools.protoc \
  -I=. --python_out=. --grpc_python_out=. --descriptor_set_out=interface1.desc grpc_interface_1.proto

# 编译第二个文件并生成描述符
python -m grpc_tools.protoc \
  -I=. --python_out=. --grpc_python_out=. --descriptor_set_out=interface2.desc grpc_interface_2.proto

2. 在Python中手动加载描述符到独立池：

from google.protobuf.descriptor_pool import DescriptorPool
from google.protobuf import descriptor_pb2

# 正常导入第一个模块（使用全局池）
import grpc_interface_1_pb2 as pb1

# 创建独立池加载第二个描述符
pool = DescriptorPool()
with open("interface2.desc", "rb") as f:
    desc_set = descriptor_pb2.FileDescriptorSet()
    desc_set.ParseFromString(f.read())
    for file_desc in desc_set.file:
        pool.Add(file_desc)

# 从独立池获取第二个消息类型
Message1_v2 = pool.FindMessageTypeByName("core.grpc_interface.Message1")
# 创建消息实例
msg2 = Message1_v2(id="test2")

注意：这种方式需要手动处理消息的序列化/反序列化，以及gRPC客户端/服务端的适配，复杂度较高，仅适合无法修改.proto的场景。

方案3：动态导入并隔离全局池（不推荐） #

通过修改sys.modules或在单独进程中导入不同模块，但这种方式会大幅增加代码复杂度，且容易引发其他隐性问题，仅作为临时应急方案。

总结 #

优先选择修改包名的方案，这是Protobuf设计的规范用法，能彻底避免后续所有潜在的冲突问题。如果无法修改.proto，再考虑使用独立描述符池的进阶方案。

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