接收复杂表单数据应使用[FromForm]+强类型模型（支持嵌套、集合），而非手动读Request.Form；[FromQuery]仅用于URL参数，二者不可混用，否则静默绑定失败。
直接说结论：接收复杂表单数据，用 [FromForm] + 强类型模型（含嵌套属性、集合），别手动读 Request.Form；而 [FromQuery] 专用于 URL 查询参数，二者不能混用，否则绑定失败且无提示。
为什么 [FromForm] 是复杂表单的唯一正解
浏览器提交 <form method="post" enctype="multipart/form-data"></form> 或普通 application/x-www-form-urlencoded 时，字段名是扁平化的键值对（如 Address.Street、Phones[0].Number）。ASP.NET Core 的 [FromForm] 绑定器能识别这种命名约定，自动递归填充嵌套对象和数组——这是 [FromBody] 做不到的（它只认 JSON 结构，且不支持文件上传）。
- 不加
[FromForm]：框架默认按“任意来源”尝试绑定，可能从查询字符串或路由里误取值，尤其当字段名重名时 - 用
[FromBody]接表单：直接返回 415 错误，因为表单数据不是合法 JSON - 嵌套属性名必须严格匹配：比如模型中
public AddressModel Address { get; set; }，表单字段就得叫Address.Street，少个点或大小写错就为 null
[FromForm] 和 [FromQuery] 的边界必须划清
它们对应完全不同的 HTTP 数据位置，强行交叉会导致静默失败或绑定空值。
-
[FromForm]只读 POST 请求体里的表单字段（含文件），忽略 URL 上的?key=value -
[FromQuery]只读 URL 查询字符串，比如/api/user?includeDetails=true&page=2，对 POST body 里的任何内容视而不见 - 同一个 Action 同时需要两者？可以共存：
public IActionResult Update([FromForm] UserForm model, [FromQuery] bool force)，但别把表单字段塞进 URL 里传 - 常见错误：前端用 AJAX 发 JSON，后端却标
[FromForm]→ 模型全为默认值，ModelState.IsValid却为 true（因为没触发验证）
嵌套对象和集合绑定的硬性条件
表单字段名不是随便起的，必须符合 ASP.NET Core 的绑定语法，否则嵌套属性永远为空。
- 嵌套对象：用点号分隔，如
<input name="Profile.Email">→ 绑定到model.Profile.Email - 数组/列表：用方括号索引，如
<input name="Hobbies[0]">、<input name="Hobbies[1]">；注意索引必须连续，跳过[0]直接写[2]会导致Hobbies为 null - 字典：用
["key"]，如<input name="Metadata[" status>（注意引号需 HTML 编码） - 文件上传必须用
IFormFile类型字段，且表单enctype必须为multipart/form-data；普通字符串字段无法接收文件
容易被忽略的验证与调试盲区
绑定失败往往不报错，而是让字段保持默认值（null、0、false），靠肉眼很难发现。
- 永远检查
ModelState.IsValid，而不是只看参数是否非空——验证失败时，ModelState里有具体字段的错误消息 - 调试时打印
Request.Form.Keys，确认浏览器实际发了哪些键；再对比模型属性名，找大小写、点号、方括号是否一致 -
[Bind]属性必须显式指定允许绑定的字段，否则攻击者可能通过伪造表单字段修改敏感属性（如IsAdmin） - 自定义验证（如密码确认）必须放在模型类里，用
IValidatableObject实现，不能只靠前端 JS——后端绑定后才走验证流程
