使用protobuf-maven-plugin生成proto代码出现错误

原创 已于 2025-10-16 23:31:33 修改 · 352 阅读 · 3 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#maven #数据库 #java

于 2025-10-16 23:30:41 首次发布

protobuf-manve-plugin生成代码出错

错误描述

使用protobuf-maven-plugin生成proto代码时，出现类似错误：
“xxx” is already defined in file “xxx.proto”

[ERROR] PROTOC FAILED: gateway/user.proto:19:9: "UserService" is already defined in file "common/user.proto".
[ERROR] E:\Projects\ranger2\game-server\game-proto\src\main\proto\common\user.proto [0:0]: gateway/user.proto:19:9: "UserService" is already defined in file "common/user.proto".

proto文件

为了便于理解错误，给出现错误时的proto文件内容。

两个proto文件位于不同的目录。
proto文件目录
common目录下的proto内容。
common目录下的proto
gateway目录下的proto内容。
gateway目录下的proto

问题解决方案

给proto文件设置package属性。
也就是关闭这两个文件的第三行注释。
package game.proto.common.user;
package game.proto.gateway.user;

成功运行

plugin
success

思绪

以前遇到过这个问题时稍微查了一下资料（没有找出原因，觉得是自己将proto文件存放在同一个目录下导致的），当时比较着急完成功能需求，就手动改了冲突的名字。
没想到今天又遇到了这个问题，所以就往命名空间方向查找问题。

参考

https://stackoverflow.com/questions/62911250/why-i-am-getting-proto-class-is-is-already-defined-in-file

ranger2
关注
【Java】protobuf-maven-plugin主动下载protoc编译proto文件
LifeIsGood
12-06 461
【Java】protobuf-maven-plugin主动下载protoc编译proto文件
【项目实战】使用maven编译proto文件的插件：protobuf-maven-plugin，在构建过程中自动化地处理 Protocol Buffers 相关的任务，比如生成 Java 类
本本本添哥
09-12 1243
2、proto中指定一下生成的类所在的包名，如：option java_package = “com.demo.service.grpc”;，帮助在构建过程中自动化地处理 Protocol Buffers 相关的任务，比如生成 Java 类或者其他语言的类。请根据你的项目需求调整版本号和其他配置项，检查是否有更新版本的插件和依赖项可用，提供更好的兼容性和新特性。第二个目标，用于生成 gRPC 相关的代码。PS：以上proto文件所在目录，和生成的java所在目录，可以在插件中更改。文件并生成相应的源代码。
使用protobuf-maven-plugin生成grpc项目
方亮的专栏
05-03 3186
在一文中，我们使用了protobuf-maven-plugin来生成proto中的message类型结构体。本文我们将使用该插件，完成grpc依赖的生成。
java使用protobuf-maven-plugin的插件编译proto文件
程序猿CKeen的专栏
04-28 2万+
java使用protobuf-maven-plugin的插件编译proto文件，实现grpc服务的打包
maven中的grpc编译插件protobuf-maven-plugin详解
技术人集结地
05-26 2454
protobuf-maven-plugin是Maven中用于编译Protocol Buffers(.proto)文件并生成对应语言代码的插件，支持gRPC服务端和客户端代码生成。文章详细解析了插件的配置方法，包括指定protoc编译器版本、gRPC插件路径、proto文件目录和输出目录等关键配置项。同时介绍了必要的gRPC依赖项、使用流程（编写proto文件→Maven编译→使用生成代码）以及常见问题解决方案，如版本匹配问题和操作系统兼容性问题。该插件实现了protobuf编译与Maven构建流程的无缝集成
使用protoc-jar-maven-plugin生成grpc项目
方亮的专栏
05-03 1623
在中我们使用protobuf-maven-plugin完成了grpc代码的翻译。本文我们将只是替换pom.xml中的部分内容，使用protoc-jar-maven-plugin来完成相同的功能。总体来说protoc-jar-maven-plugin方案更加简便。
Idea+protobuf-maven-plugin插件编译proto文件生成客户端和服务端代码
热门推荐
JesJiang的博客
09-06 2万+
首先，定义test.proto文件，官网样例如下 syntax = "proto3";//请在非空非注释的第一行指定当前文件使用的是proto3的语法,默认proto2 package grpc;//package与java_package有些不同，java_package是定义编译生成的java文件所在的目录，而package是对应的java类的命名空间 option java_package ...
执行目标org. xolice .maven.plugins:protobuf-maven-plugin:0.6.1:compile(默认)项目proproo -test: protoc没有干净地退出
qq_38867322的博客
04-25 1954
Grpc中的错误
protobuf-maven-plugin编译失败
vinson的博客
09-07 1万+
protobuf-maven-plugin编译失败protobuf-maven-plugin编译失败问题现象问题原因 protobuf-maven-plugin编译失败 问题现象 [ERROR] PROTOC FAILED: ???????????????? [ERROR]xxxxxxx\message.proto [0:0]: ???????????????? [INFO] ----------------------------------------------------------------
精选资源
protoc-jar-maven-plugin:协议缓冲区protobuf maven插件-基于protoc-jar多平台可执行文件protoc JAR
04-29
协议缓冲区protobuf maven插件-使用多平台可执行协议protoc JAR执行protobuf代码生成。 在Maven Central上可用： : 简单的maven插件，可使用protoc 嵌入式protoc编译器来编译.proto文件，从而在主要平台（Linux，...
protoc-maven-plugin
07-05
使用 `protoc-maven-plugin` 可以使 Protobuf 项目更容易维护和集成到现有的 Maven 构建流程中，避免手动编译 `.proto` 文件，提高了开发效率。此外，由于它是开源项目，社区提供了持续的更新和支持，你可以根据需要...
protobuf-maven-plugin
09-07
在项目中的 src/main/proto 目录下放置 protobuf 文件（扩展名为 .proto），执行 Maven 构建时，protobuf-maven-plugin 将会自动生成对应的 Java 类，并将生成的 Java 类编译成字节码文件。 请注意，protobuf-maven...
2025 Maven终极实战：AI与云原生构建新范式
最新发布
m0_62475782的博客
12-06 572
摘要： 在AI时代，Maven凭借其标准化工程规范仍不可或缺，2024年数据显示87%的云原生Java项目采用Maven。Maven 4.0引入CATALOG依赖管理、虚拟线程支持和AI优化构建缓存等革新，通过企业级依赖清单和量子安全预备确保可靠性。AI工具如Maven Copilot可自动生成优化配置，解决依赖冲突，同时支持云原生多运行时架构（JVM/GraalVM/WebAssembly）。Maven作为工程底座，为AI协作、持续集成和未来技术演进提供了标准化基础。
Maven BOM（Bill of Materials）使用指南与常见错误
SpringBoy的博客
12-03 569
Maven BOM（Bill of Materials）是统一管理依赖版本的核心工具，其本质是一个特殊Maven项目（pom类型），通过dependencyManagement节点声明依赖版本。主要优势在于统一版本控制、减少冲突和简化升级流程。使用场景包括：1）导入官方/第三方BOM（如Spring Boot）统一生态依赖版本；2）自定义BOM管理多模块项目共用依赖。使用时需注意固定格式（type=pom+scope=import）和版本继承规则。常见问题如依赖版本冲突可通过检查BOM覆盖范围解决。BOM是
Maven 的下载安装配置教程
2301_77987130的博客
12-02 1010
本文详细介绍了Maven的下载、安装、配置及在IDEA中的集成方法。Maven作为Apache开源项目，通过POM模型管理Java项目的构建过程。主要内容包括：从官网下载Maven压缩包并解压安装；配置本地仓库路径和阿里云镜像以加速依赖下载；设置MAVEN_HOME环境变量；以及在IDEA中分别进行当前项目和全局的Maven配置。文中提供了具体的操作步骤和配置示例，帮助开发者快速搭建Maven开发环境。通过本文指导，读者可完成从Maven安装到IDE集成的完整配置流程。
【JavaWeb】----- Maven入门与实践
2401_82676816的博客
12-03 835
Maven 的构建过程是高度标准化和自动化的，其核心机制之一就是生命周期（Lifecycle）。生命周期将项目的构建流程划分为一系列有序的阶段（Phase），确保不同项目在不同环境下都能以统一的方式完成编译、测试、打包和部署等操作。核心目标：对所有 Maven 项目构建过程进行抽象与统一，提升开发效率和可维护性。软件测试是软件开发过程中不可或缺的关键环节，旨在通过系统化的验证手段，确保软件在功能、性能、安全性等方面满足预期要求。测试（Testing）
maven 仓库的Central Portal Namespaces 怎么验证
曼陀罗的博客
12-05 412
在 Maven Central（中央仓库）上配置 Namespaces（命名空间） 的验证是确保你的 Group ID（GroupId）所有权的重要步骤。在 GitHub 创建仓库：https://github.com/yourusername/yourusername.github.io。对于个人 Group ID：io.github.yourusername。主机名：_deploy.yourusername.github.io。主机名：yourcompany.com。
《Maven 核心功能与仓库体系详解》
2501_93037119的博客
12-02 940
Name→ 项目根文件夹名（比如最外层的demo文件夹）；→ 决定（比如→ 对应 Java 代码的根包结构（com→dyk→demo举个例子：如果把Group改成org.baiduArtifact改成search，那会默认是，包结构就会是org→baidu→search配置项中文释义核心作用我的配置值对应路径 / 结构通俗理解Name项目名称IDE / 文件系统显示的「项目根文件夹名」（仅用于可视化，无技术作用）demo（最外层文件夹）给项目起的 “外号”（人看的）Group。
protobuf-maven-plugin使用
12-07
protobuf-maven-plugin是一个Maven插件，用于将Protocol Buffers文件编译为Java类。以下是protobuf-maven-plugin的使用方法： 1.在pom.xml文件中添加以下插件配置： ```xml <build> <plugins> <plugin> <groupId>org.xolstice.maven.plugins</groupId> <artifactId>protobuf-maven-plugin</artifactId> <version>0.6.1</version> <configuration> <protocExecutable>/usr/local/bin/protoc</protocExecutable> </configuration> <executions> <execution> <goals> <goal>compile</goal> <goal>compile-custom</goal> <goal>test-compile</goal> <goal>test-compile-custom</goal> </goals> </execution> </executions> </plugin> </plugins> </build> ``` 2.在src/main/proto目录下创建.proto文件，例如： ```protobuf syntax = "proto3"; package com.example; message Person { string name = 1; int32 age = 2; } ``` 3.运行以下命令编译.proto文件： ```shell mvn protobuf:compile ``` 4.编译后的Java类将生成在target/generated-sources/protobuf/java目录下。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值