Python Protoc编译生成无效导入引发ModuleNotFoundError求助

问题根源 #

Mimir的proto文件依赖gogo protobuf的扩展定义，你用标准protoc编译生成的Python代码，会把proto中的import "github.com/gogo/protobuf/gogoproto/gogo.proto"转换为Python的包导入路径，但你的Python环境中没有对应结构的模块，因此抛出找不到github模块的错误。

解决方法 #

方法1：手动编译gogo protobuf依赖

1. 在你的项目根目录下创建如下目录结构：

   github.com/gogo/protobuf/gogoproto/
   

2. 将gogo protobuf的gogo.proto文件放入上述目录（该文件是gogo protobuf的核心扩展定义）
3. 用protoc编译该proto文件生成Python模块：

   protoc --python_out=. github.com/gogo/protobuf/gogoproto/gogo.proto
   

   执行后会生成github.com/gogo/protobuf/gogoproto/gogo_pb2.py文件
4. 确保项目根目录在Python的搜索路径中：
   • 临时通过代码添加：import sys; sys.path.append("/你的项目根目录路径")
   • 或设置环境变量：export PYTHONPATH="/你的项目根目录路径:$PYTHONPATH"

方法2：编译时指定依赖搜索路径

1. 克隆gogo protobuf的仓库到本地（或仅下载github.com/gogo/protobuf/目录下的内容）
2. 编译Mimir的proto文件时，通过--proto_path参数指定gogo protobuf的根路径：

   protoc --python_out=. --proto_path=/path/to/gogo/protobuf/repo --proto_path=. mimir.proto
   

   这样protoc会自动找到依赖的gogo.proto，生成的Python代码导入路径会匹配正确的模块结构

补充说明 #

gogo protobuf是Protobuf的增强实现，提供了更快的序列化性能和额外字段选项，Mimir依赖它定义自定义Protobuf规则，因此必须处理该依赖才能正常使用生成的Python模块。

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