以下是在Debian上調試Swagger的實用技巧:
安裝與部署
sudo apt update && sudo apt install nodejs npm
,隨后安裝swagger-jsdoc
和swagger-ui-express
。swag init
生成文檔,需先安裝Go環境及gin-swagger
等依賴。本地調試
http://localhost:端口號/api-docs
查看Swagger UI,直接測試接口。日志與錯誤排查
swagger-ui-express
的requestInterceptor
和responseInterceptor
。journalctl
、logrotate
)管理日志文件,監控異常。高級測試工具
docker logs
查看容器日志。文檔與協作
關鍵命令參考:
npm install -g swagger-jsdoc swagger-ui-express
node app.js
(需在代碼中集成Swagger中間件)journalctl -u 服務名
(針對Docker或系統服務)