Postman发POST请求返回Could not process payload报错是什么原因？

请求格式相关问题 #

• 请求头配置错误：传递JSON请求体时必须携带Content-Type: application/json请求头，若漏填、填错为表单格式，服务端无法按JSON规则解析内容，就会触发该报错。
• JSON语法不合法：这是该报错最高发的诱因，常见问题包括：JSON末尾多余逗号、引号未闭合、嵌套括号不匹配、误用中文标点（中文引号、中文逗号等）、布尔值/数值类型多余添加引号。可以先将请求体复制到本地JSON校验工具做语法合法性检测。
• 字符编码错误：如果请求体包含非ASCII字符（中文、特殊符号等），未使用UTF-8编码会导致服务端解码失败，可在Postman请求配置页确认编码格式为UTF-8。

数据校验不通过问题 #

• 必填字段缺失或层级错误：接口要求的必填字段未传递，或字段嵌套层级与接口要求不符，比如应该放在data.user下的字段直接放在JSON根层级。
• 字段类型不匹配：比如接口要求某字段为数值类型，实际传了带引号的字符串；要求为数组类型，实际传了单个字符串；要求为布尔值true/false，实际传了字符串"true"。
• 字段取值不符合约束：字符串长度超出接口限制、枚举值传递了不在允许范围内的内容、数值超出接口支持的精度范围、空列表传递了null而非[]，都会触发服务端参数校验失败。
• 嵌套列表结构异常：列表内元素结构不统一、嵌套层级和接口要求不符、列表长度超出限制。

其他排查方向 #

• 请求基础信息错误：确认接口要求的请求方法为POST，而非PUT/PATCH等其他方法；检查接口地址https://some.base.url/v0/resource/resource-id拼写正确，路径参数resource-id无多余前后空格、取值符合规则。
• 鉴权信息异常：部分服务端鉴权失败时会返回通用payload处理错误，需要确认Authorization等鉴权头配置正确，令牌未过期、权限匹配。
• 请求体大小超限：如果请求体包含大段文本或大量列表元素，超出接口设定的最大payload大小限制也会触发报错，可先仅传递必填字段构造最简请求体测试，再逐步补充内容定位问题。

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