Spring Boot项目中实现API文档化的最优方式有哪些？

目前行业内常用的实现方案有以下三种：

• SpringFox Swagger：是Spring生态早期普及率最高的Swagger2集成方案，支持通过注解快速生成可交互的接口调试文档，该项目目前已停止更新，对Spring Boot 2.6及以上高版本兼容性较差，更适配低版本老项目。
• springdoc-openapi：当前业内主流的OpenAPI 3规范集成方案，原生适配Spring Boot 2.x、3.x全版本，支持开箱即用的注解配置，可同时输出结构化接口元数据和可视化调试页面，是新建项目的首选方案。
• 原生io.swagger.v3.oas.integration.SwaggerConfiguration配置：适合需要高度自定义OpenAPI文档规则的场景，可通过编码方式全局配置文档基础信息、全局公共参数、接口认证规则等，灵活性最高，通常和springdoc-openapi搭配使用。

选型参考：维护低版本老项目可沿用SpringFox Swagger；新建项目优先选择springdoc-openapi，有定制化需求时可搭配SwaggerConfiguration进行编码配置。

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