Postman用x-www-form-urlencoded提交List对象时，参数名必须写成positionIdList[0].id、positionIdList[0].name等带索引和点号的扁平化格式，Spring才能正确绑定到List字段，因其依赖属性编辑器与索引路径机制解析表单数据。
Postman 用 x-www-form-urlencoded 提交 List 对象时参数名怎么写
直接写 positionIdList[0].id、positionIdList[0].name、positionIdList[1].id 这种带索引和点号的键名，Spring Boot / Spring MVC 才能正确绑定到 List 字段。
原因在于：Spring 的 WebDataBinder 对 x-www-form-urlencoded 数据使用「属性编辑器 + 索引路径」机制解析，它不认 JSON 数组结构，只认形如 xxx[0].yyy 的扁平化键名。
- 不能写成
positionIdList后跟一个 JSON 字符串（比如[{"id":"1","name":"A"}]），这会被当作文本字段，后端收不到 List - 不能省略索引，比如只写
positionIdList.id—— 框架无法判断这是单个对象还是列表元素 - 索引必须从 0 开始连续，跳号（如 [0]、[2]）可能导致中间项为 null 或绑定失败
Content-Type 和 Body 类型必须严格匹配
选 x-www-form-urlencoded 就必须配 Content-Type: application/x-www-form-urlencoded；Postman 默认会自动加这个头，但如果你手动改过 Headers，就得确认它没被覆盖或删掉。
常见错误是：Body 选了 x-www-form-urlencoded，但 Headers 里手写了 Content-Type: application/json —— 此时 Spring 会尝试用 @RequestBody 解析，而表单数据根本不是合法 JSON，结果直接 400 或参数全 null。
- Postman 的
x-www-form-urlencoded模式会自动 URL 编码值（空格→+，@→%40等），不需要手动编码 - 如果值里含
&、=或中文，放心填，Postman 会处理；但若手动切到raw模式再拼字符串，就极易出错 - 不要在
x-www-form-urlencoded下混用form-data的字段类型（比如把某个 key 设成 file）—— 它不支持
@RequestBody 接收 List 是另一条路，别和表单混用
如果你在 Controller 方法上写了 @RequestBody List，那 Postman 必须切到 raw → JSON 模式，并发纯 JSON 数组，例如：
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
{"positionIdList":[{"id":"1","name":"Dev"},{"id":"2","name":"QA"}]}
这时候 Content-Type 必须是 application/json，且后端接收类必须是顶层对象（不能直接 @RequestBody List，Spring 不支持这种裸集合）。
-
@RequestBody List在 Spring 5.3+ 有有限支持，但需配合@JsonFormat或自定义反序列化器，生产环境建议包一层 VO - 表单方式（
x-www-form-urlencoded）和 JSON 方式（raw/JSON）是两套完全独立的绑定流程，不能交叉配置 - 日志里看到
Resolved argument of type [java.util.List]说明走对了表单绑定；看到HttpMessageNotReadableException基本就是 JSON 解析失败
嵌套 List 的边界情况：空列表和 null 怎么传
前端传空列表时，Postman 里不填任何 positionIdList[x].* 键即可，Spring 默认绑定为空 ArrayList；但如果后端字段声明为 private List，效果更稳。
想传 null 列表？表单协议本身不支持「显式传 null」，因为没提交对应键就等于缺失。若业务强依赖区分「未传」和「传了空数组」，得换方案：比如加个标志字段 hasPositionList=false，或直接切 JSON 模式传 "positionIdList": null。
- 单个元素的
id或name为空字符串（如positionIdList[0].id=），会绑定为""，不是null - 如果某一项漏填
name但填了id，name字段会是null，取决于你的 VO 是否允许 null - Lombok 的
@Setter和无参构造器必须存在，否则 Spring 实例化失败，报InstantiationException
