使用Swagger测试POST接口时出现400验证错误，寻求解决方案

错误原因分析 #

返回的400错误明确提示请求体（body）未提供，结合代码和配置，核心问题点有三个：

1. Swagger配置的控制器名称拼写错误 #

/recipe路径下的x-swagger-router-controller字段写成了repice，但实际控制器文件是recipe.js，拼写错误会导致路由无法正确映射到处理函数，间接引发请求体验证失败。

2. 未配置JSON请求体解析中间件 #

如果项目基于Express框架，默认不会自动解析JSON格式的请求体，导致req.body为空，Swagger验证时判定“请求体未提供”。

3. Swagger的operationId与控制器函数不匹配 #

Swagger中POST接口的operationId是postRecipes，但recipe.js导出的处理函数是createRecipe，名称不匹配会导致Swagger找不到对应的处理逻辑。

具体修复步骤 #

步骤1：修正Swagger配置的拼写与匹配问题 #

修改Swagger YAML配置：

paths:
  /recipe:
    # 修正控制器名称拼写
    x-swagger-router-controller: recipe
    get:
      # 保留原有GET接口配置
      description: Return all the recipes
      operationId: getAllRecipes
      responses:
        200:
          description: Success get all the recipes
          schema:
            type: array
            items:
              $ref: "#/definitions/Recipe"
        500:
          description: Unexpected Error
          schema:
            type: object
            properties:
              # 修正拼写错误：messeage → message
              message:
                type: string
    post:
      description: Create one new Recipe
      # 修正operationId，与控制器导出函数名一致
      operationId: createRecipe
      parameters:
        - in: body
          name: body
          description: The recipe to be added
          required: true
          schema:
            $ref: "#/definitions/Recipe"
      responses:
        204:
          # 修正拼写错误：rescipe → recipe
          description: Success adding the recipe
        500:
          description: Unexpected Error
          schema:
            type: object
            properties:
              # 修正拼写错误：messeage → message
              message:
                type: string

步骤2：添加JSON请求体解析中间件 #

在Express主入口文件（如app.js/server.js）中，添加以下中间件（需放在路由注册之前）：

const express = require('express');
const app = express();

// 解析JSON格式的请求体
app.use(express.json());

// 注册Swagger路由和业务路由
// ... 其他代码

步骤3：规范请求发送格式 #

调用POST接口时，确保：

• 请求头包含Content-Type: application/json
• 请求体符合Recipe定义的JSON结构，示例：

{
  "name": "番茄意面",
  "description": "简易家常番茄意面",
  "ingredients": ["意面", "番茄酱", "大蒜"]
}

验证修复效果 #

完成修改后重启项目，调用POST接口：

• 会返回204状态码
• 新的recipe会被正确添加到recipeList数组中

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