Node.js中Swagger UI参数与响应无法正常显示问题求助

你的问题出在注释的层级缩进错误：parameters和responses没有嵌套在get方法的配置里，Swagger解析时会把它们当成接口路径/test的同级内容，而非GET请求的属性，所以UI界面无法识别展示。

修正后的正确注释代码：

// Routes
/**
* @swagger
* /test:
*      get:
*           description: 返回所有用户
*           parameters:
*               - name: customer
*                 in: query
*                 description: 模型名称
*                 required: true
*                 schema:
*                   type: string
*                   format: string
*           responses:
*               '200':
*                   description: 成功返回分页记录
*               '403':
*                   description: 权限不足，无法读取模型数据
*/

修改说明 #

• 将parameters和responses的缩进调整到与get下的description同一层级，确保它们属于GET请求的配置项
• 同时把注释里的英文描述翻译成了中文，方便国内开发查看

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