protoc导入同包其他proto文件提示未找到或类型未定义报错

问题根因说明 #

protoc解析import路径的规则是完全基于--proto_path（简写-I）参数指定的搜索根目录匹配，不会默认以当前正在编辑的proto文件所在目录作为搜索起点，这是绝大多数同项目proto导入报错的核心原因。只要import路径配置正确、能正常加载依赖的proto文件，后续连带的User未定义报错会自动消失。
你的现有项目目录结构如下：

protos/
├── auth/
│   ├── auth_service.proto
│   └── user.proto
└── some_other/

你在auth_service.proto中写的import "auth/user.proto"语法本身没有问题，按以下步骤逐一排查即可解决： #

排查解决步骤 #

• 第一步：校验执行protoc命令时的-I参数配置
  你写的import路径是auth/user.proto，意味着protoc必须能在某个-I指定的根目录下找到auth/user.proto这个子路径，也就是必须把protos文件夹本身加入搜索路径。
  举个正确的命令示例：如果你当前终端在protos文件夹的上一级目录，执行编译的命令应该是：

  protoc -I=./protos --<对应语言的生成参数，比如--go_out=./gen> ./protos/auth/auth_service.proto
  

  常见错误场景：

  1. 漏传-I参数：protoc默认只把终端当前所在目录作为搜索根，如果你在auth目录下直接执行protoc auth_service.proto，protoc会去找./auth/user.proto也就是protos/auth/auth/user.proto，必然找不到文件
  2. -I参数传错：比如把-I指向了./protos/auth目录，那protoc会去找./protos/auth/auth/user.proto，同样找不到

• 第二步：校验文件命名与权限
  • 确认user.proto文件名和import语句中的拼写完全一致，注意Linux系统文件路径区分大小写，不要出现User.proto、user.PROTO这类大小写不匹配的问题
  • 确认执行protoc命令的系统用户对protos/auth下所有proto文件有读权限，没有被系统权限规则拦截
• 第三步：验证proto文件本身无语法错误
  单独编译user.proto验证文件合法性，在protos上一级目录执行：

  protoc -I=./protos ./protos/auth/user.proto -o /dev/null
  

  如果这条命令执行无任何输出，说明user.proto本身语法完全正常，报错就只和路径配置有关。

可选优化写法 #

因为两个proto文件同属auth包、存放在同一目录下，你也可以改用同目录相对导入，把auth_service.proto里的import语句改成：

import "user.proto";

使用这种写法时，需要把protos/auth目录也加入protoc的搜索路径，命令示例：

protoc -I=./protos -I=./protos/auth --go_out=./gen ./protos/auth/auth_service.proto

更推荐统一以protos作为唯一搜索根、import写从根开始的全路径的方案，项目规模扩大后路径管理更清晰，不容易出现路径冲突。 #

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