1. 修复 Swagger UI 渲染空白问题
前端开发工程师背景
团队使用 Swagger 2.0 定义接口,但在更新完一个用户模块的接口后,Swagger UI 页面直接报错且无法渲染。
问题
难以在数千行的 JSON 文档中手动找出损坏的 $ref 引用或语法错误。
如何使用
将完整的 Swagger JSON 粘贴到 specInput 输入框中,校验器会自动运行分析。
{
"swagger": "2.0",
"info": {
"title": "User API",
"version": "1.0.0"
},
"paths": {
"/users": {
"get": {
"responses": {
"200": {
"schema": {
"$ref": "#/definitions/UserMissing"
}
}
}
}
}
}
}结果
校验器立即指出 #/definitions/UserMissing 引用未定义,补全该组件后 Swagger UI 恢复正常。