Postman Mock API如何基于Form-Data参数返回对应响应？

我之前也踩过Postman Mock处理multipart/form-data请求体匹配的坑，结合你的场景，给你梳理下仅通过请求体字段匹配的解决方案，亲测有效：

1. 先确保Mock集合的请求模板配置正确 #

Postman Mock的匹配逻辑是和你在集合中定义的请求模板做对比，所以模板必须和实际发送的请求结构完全对齐：

• 打开你的Postman集合，找到要Mock的POST请求，切换到Body标签，选择form-data类型
• 添加check字段，注意值的类型要和实际发送的一致：如果实际发送的是字符串"true"/"false"（Form-Data默认都是字符串类型），模板里就选「文本」类型，填入"true"；不要选布尔类型的true，否则匹配会失败
• 给这个模板保存第一个响应（比如返回你需要的JSON数组）
• 复制这个请求模板，修改check字段值为"false"，保存第二个响应（返回JSON对象）

2. 调整Mock的请求体匹配规则 #

默认情况下Postman Mock会做请求体完全匹配，如果你的实际请求还带了其他Form-Data字段，就会触发mockRequestNotFoundError。我们需要改成部分匹配：

• 进入你的Mock服务器设置，找到对应的POST请求
• 在「匹配规则」里，找到「请求体」选项，把匹配方式从「完全匹配」改成「部分匹配」
• 这样只要check字段的值匹配，其他字段不影响Mock的响应匹配

3. 实际请求的正确配置 #

发送请求时，必须带上两个关键配置：

• 请求头：添加x-mock-match-request-body: true，这个头是告诉Mock服务器要匹配请求体内容；同时确保Content-Type是multipart/form-data（Postman会自动帮你生成带boundary的Content-Type，不用手动写）
• 请求体：选择form-data，添加check字段，值填"true"或"false"（注意是字符串类型，和模板一致）

4. 验证效果 #

现在发送请求：

• 当check=true时，Mock会返回你配置的JSON数组
• 当check=false时，返回JSON对象
• 不会再出现mockRequestNotFoundError

为什么之前加了x-mock-match-request-body会报错？ #

大概率是你的请求模板和实际请求的Form-Data不匹配：比如字段名大小写不一致、值的类型不匹配（模板用了布尔值，实际发了字符串），或者默认的完全匹配模式下，实际请求多了其他字段导致不匹配。调整成部分匹配+对齐模板字段后就能解决。

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