两个.proto文件含同名message导致protoc编译Java代码报错

错误根源 #

两个.proto文件中的env消息没有通过命名空间（包名）或唯一外部类名区分，Protobuf编译器将它们判定为同一类型，因此抛出命名冲突错误。默认情况下，编译器不会自动根据文件名生成不同的外部类，必须显式配置相关选项。

解决方法 #

方法1：指定唯一的Java外部类名 #

在每个.proto文件中添加java_outer_classname选项，明确指定生成的外部类名称：

a.proto

syntax = "proto3";
option java_outer_classname = "A";

message env {
  string broker = 1;
}

b.proto

syntax = "proto3";
option java_outer_classname = "B";

message env {
  string broker = 1;
}

重新执行编译命令后，会生成A.java和B.java，每个文件中都包含嵌套的Env类。

方法2：使用不同的包名隔离 #

为每个.proto文件指定独立的包名，同时可配合java_package自定义Java包路径：

a.proto

syntax = "proto3";
package a;
option java_package = "com.example.a";

message env {
  string broker = 1;
}

b.proto

syntax = "proto3";
package b;
option java_package = "com.example.b";

message env {
  string broker = 1;
}

这种方式会将生成的类放到不同的Java包下，即使嵌套类名都是Env，也不会产生冲突，外部类默认以文件名的大驼峰形式生成（A.java和B.java）。

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