如何通过Swagger发送url-encoded格式数据？接口接收不到数据

1. Swagger注释的核心问题 #

你当前的Swagger配置用了已弃用的formData参数格式，和consumes的搭配在新版本OpenAPI规范里不兼容，这会导致Swagger UI发送的请求格式不符合后端预期。另外还有一处拼写错误：

• password字段的描述写成了desription（少了字母c），虽不影响功能，但建议修正。

2. 修正后的Swagger配置 #

把parameters替换为requestBody来定义表单数据，符合OpenAPI 3.x规范：

/**
 * @swagger
 * /clients/updatePassword:
 *  post:
 *      summary: 修改客户密码（通过邮箱和原密码验证）
 *      requestBody:
 *        required: true
 *        content:
 *          application/x-www-form-urlencoded:
 *            schema:
 *              type: object
 *              required:
 *                - email
 *                - password
 *                - newPassword
 *              properties:
 *                email:
 *                  type: string
 *                  description: 客户邮箱
 *                password:
 *                  type: string
 *                  description: 客户原密码
 *                newPassword:
 *                  type: string
 *                  description: 客户新密码
 *      responses:
 *        200:
 *          description: 密码修改成功
 *        400:
 *          description: 请求无效，邮箱或密码参数缺失或错误
 *        401:
 *          description: 验证失败，身份信息错误
 *        500:
 *          description: 服务器错误，连接过程中发生异常
 */
router.post("/updatePassword", updatePassword);

3. 后端中间件检查 #

如果用的是Express框架，务必在路由配置前添加解析application/x-www-form-urlencoded格式数据的中间件，否则后端无法接收表单数据：

app.use(express.urlencoded({ extended: true }));

4. 验证步骤 #

修改后重启服务，在Swagger UI中重新测试：

• 确认请求头的Content-Type为application/x-www-form-urlencoded
• 检查表单参数填写正确后发送请求

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