是否有可同时生成gRPC和OpenAPI文档的一体化工具？

最佳方案：仅输入Proto生成统一文档 #

如果你的Proto文件已经配置好google.api.http注解，完全可以实现仅传Proto就同时输出gRPC和HTTP两类接口的统一文档，具体实现流程：

• 第一步用protoc-gen-openapiv2插件直接从Proto生成对应HTTP接口的OpenAPI规范文件，无需额外维护独立的Swagger定义
• 第二步搭建统一的渲染层：
  • 解析Proto的descriptor set文件提取gRPC接口的所有定义，包括请求/响应结构、方法说明、字段注释
  • 读取生成的OpenAPI文件提取HTTP接口的路径、请求方法、参数约束
  • 前端增加统一的切换控件，支持在同一页面切换查看两类接口的调用说明、示例代码、返回结构
• 样式层面可以复用成熟OpenAPI文档的设计规范，保证两类接口的视觉风格完全一致

次选方案：兼容现有Proto+Swagger双输入 #

如果你不想改动当前的工作流，已经有单独维护的Swagger文件和Proto文件，可以用聚合方案实现统一文档：

• 保留现有的Swagger文档生成逻辑和protoc-gen-doc生成逻辑
• 开发统一的入口页面，通过样式覆写统一两类文档的配色、字体、排版规范，用切换按钮控制展示对应类型的接口文档
• 如果需要更深的整合，可以写脚本分别提取protoc-gen-doc的输出内容和Swagger的JSON数据，统一渲染到同一前端框架内，彻底消除两份文档的割裂感

补充说明 #

目前确实没有开箱即用的成熟工具完全匹配这个需求，这个方向的商业化产品可以重点打磨几个核心功能：一键生成、多协议一键切换、多语言调用示例自动生成、在线调试（同时支持gRPC和HTTP请求调试）、权限管控，这些都是当前现有工具普遍缺失的能力，有明确的市场需求。

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