OpenAPI配置问题：POST接口/test已设置非空请求体及必填字段，但Postman仍可发送空请求体如何解决

这问题我之前踩过坑！核心点要搞清楚：OpenAPI本身只是一个声明性的接口规范，它不会自动帮你做请求体的校验——你看到Postman能发空{}还成功，本质是因为你的后端服务没有按照OpenAPI定义去执行校验逻辑，而Postman默认也不会严格强制符合OpenAPI规范。

下面分步骤给你解决思路：

第一步：先确认你的OpenAPI定义是否正确 #

首先检查你的schema结构有没有写错，required字段的位置很关键。正确的OpenAPI 3.x定义应该是这样的：

openapi: 3.0.3
paths:
  /test:
    post:
      summary: 测试接口
      requestBody:
        required: true  # 标记请求体必填
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TestRequest'
components:
  schemas:
    TestRequest:
      type: object
      required:
        - testName  # 标记testName为必填字段
      properties:
        testName:
          type: string
          description: Test

如果你的定义里required字段嵌套位置不对（比如放在properties里），那规范本身就有问题，先修正这个。

第二步：在后端实现请求体校验 #

这是解决问题的核心，因为OpenAPI规范只是契约，真正的拦截要靠后端逻辑：

• Java Spring Boot：在接收请求体的参数上添加@Valid或@Validated注解，同时确保引入了spring-boot-starter-validation依赖。比如：

  @PostMapping("/test")
  public ResponseEntity<String> test(@Valid @RequestBody TestRequest request) {
      // 业务逻辑
      return ResponseEntity.ok("success");
  }
  

  当请求体缺少testName时，Spring会自动返回400 Bad Request错误。

• Node.js Express：可以用express-validator或者joi库，根据你的OpenAPI schema编写校验规则。比如用joi：

  const Joi = require('joi');
  const testSchema = Joi.object({
    testName: Joi.string().required().description('Test')
  });
  
  app.post('/test', (req, res) => {
    const { error } = testSchema.validate(req.body);
    if (error) {
      return res.status(400).json({ error: error.details[0].message });
    }
    // 业务逻辑
    res.send('success');
  });
  

• Python FastAPI：FastAPI本身基于Pydantic，只要你的Pydantic模型对应OpenAPI的required定义，就会自动校验：

  from pydantic import BaseModel, Field
  from fastapi import FastAPI, Body
  
  app = FastAPI()
  
  class TestRequest(BaseModel):
      testName: str = Field(description="Test")
  
  @app.post("/test")
  async def test(request: TestRequest):
      return {"message": "success"}
  

  缺少testName时，FastAPI会直接返回422 Unprocessable Entity错误。

第三步：（可选）在Postman中添加校验脚本（仅测试阶段用） #

如果你只是想在Postman测试时确保请求符合规范，可以添加Pre-request Script来拦截不符合的请求：

// Pre-request Script 代码
try {
  const requestBody = pm.request.body.raw;
  if (!requestBody) {
    throw new Error("请求体不能为空");
  }
  const bodyObj = JSON.parse(requestBody);
  if (!bodyObj.testName || typeof bodyObj.testName !== 'string' || bodyObj.testName.trim() === '') {
    throw new Error("请求体必须包含非空的testName字符串字段");
  }
} catch (err) {
  pm.sendRequest({ url: 'about:blank', method: 'GET' }, function () {
    throw err; // 抛出错误阻止请求发送
  });
}

总结 #

Postman能发送空请求体成功，不是OpenAPI定义的问题，而是：

1. Postman默认不强制执行OpenAPI规范的校验
2. 后端没有按照OpenAPI契约实现请求体校验

只要在后端加上对应的校验逻辑，就能拦截不符合要求的请求啦！

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