在Linux系统上调试Swagger API的技巧主要包括以下几个方面：
安装与配置Swagger
- 使用Docker容器部署：推荐的方法，可以简化安装过程并避免依赖管理的复杂性。
- 使用npm安装：适用于需要更精细控制的情况，需要预先安装Node.js和npm。
- Spring Boot集成Swagger：对于Spring Boot项目，推荐使用Springdoc OpenAPI来集成Swagger。
调试技巧
- 自定义JavaScript脚本：在Swagger UI的wwwroot/swagger-ui/目录下创建一个custom.js文件，编写自定义函数用于自动授权Swagger。
- 静态文件服务：确保应用正确地启用了静态文件服务，以便Swagger UI能够正常加载所有必要的文件。
- JavaScript注入：使用InjectJavascript机制将custom.js脚本注入到Swagger UI中间件中，实现自动授权等功能。
错误处理与安全性
- 身份验证：实现Basic身份验证机制，例如创建一个自定义拦截器(SwaggerAuthInterceptor)，并在preHandle方法中执行身份验证逻辑。
- 访问控制列表(ACL)：通过对Swagger的URI进行过滤，仅允许授权用户访问敏感的API文档。
访问Swagger UI
- 在浏览器中访问
http://localhost:8080/swagger-ui/index.html 查看Swagger UI。
导入和使用Swagger
- 在Swagger Editor中导入Swagger配置文件，测试API接口。
以上就是在Linux系统上调试Swagger API的一些技巧，希望对您有所帮助。