如何在Debian系统上遵循最佳实践高效集成Swagger？

一、环境准备与基础配置

在 Debian 程序上进行任何开发前。都必须确保程序处于最新状态，否则旧版库会导致依赖冲突和安全漏洞。

sudo apt update && sudo apt upgrade -y
# 安装 JDK 与 Maven
sudo apt install -y openjdk-11-jdk maven
# 安装 Node.js 与 npm
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

二、技术栈选型与依赖管理

不同语言/框架的项目对应的 Swagger 实现各不相同，选错依赖是多数团队踩坑的根本原因。

Spring Boot 项目

• 推荐使用 springdoc-openapi-starter-webmvc-ui避免旧版 springfox 的兼容性问题。
• 若仍需使用 Springfox，请锁定到 3.0.0 并配合 springfox-boot-starter。