KONG API网关是否支持Swagger-UI？社区版能否自动生成Swagger Schema？

核心结论 #

• KONG社区版原生没有内置自动生成Swagger Schema的插件，也没有官方支持的直接导出Swagger文档的插件。

替代实现方案 #

1. 手动维护Swagger文档并关联KONG路由 #

手动编写符合OpenAPI规范（Swagger是OpenAPI的旧版本）的YAML/JSON文档，通过SwaggerUI加载这份文档，同时在KONG路由配置中确保路径、方法与文档定义一致。这种方式适合路由结构相对稳定的场景。

2. 利用KONG Admin API自定义生成Swagger文档 #

调用KONG的Admin API（比如/routes、/services接口）获取所有路由和服务的元数据，编写脚本将这些元数据转换为OpenAPI格式的文档：

• 提取路由的paths、methods、hosts等字段
• 关联对应的服务地址作为servers配置
• 按需补充参数、响应等Schema信息（这部分需要手动补充，因为KONG社区版不记录请求/响应的Schema细节）
  生成文档后即可用SwaggerUI展示。

3. 借助第三方开源工具 #

社区有一些非官方的开源工具可以尝试，比如基于KONG Admin API同步生成OpenAPI文档的脚本或工具，但这类工具没有官方维护，需要自行评估兼容性和稳定性。

注意事项 #

• KONG企业版提供了API Analytics和文档管理的原生功能，支持自动生成OpenAPI文档并集成SwaggerUI，但社区版无此特性。
• 如果需要自动生成Schema，可在API服务本身嵌入Swagger/OpenAPI注解（比如Spring Boot的SpringDoc、FastAPI的自动文档），然后将服务的Swagger文档与KONG路由关联展示，而非从KONG侧生成。

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