ASP.NET Core MVC中GET动作嵌套模型绑定与路由配置实现

所有尝试无法拿到正确id值的根本原因有两点：

• ASP.NET Core 路由模板支持的占位符是纯字符串命名的路径段，不支持用点分层级的嵌套路径写法（例如{model.customer.id}）作为占位符。这类写法生成的路由值键名就是完整的字符串"model.customer.id"，默认模型绑定器不会自动拆分点号层级，为嵌套对象的深层属性赋值。
• 模型绑定源规则错配：给CustomerDetails模型标记[FromQuery]后，整个模型的所有属性默认只会从URL查询串（?后面的参数）读取值，完全不会读取路由段中的参数，自然无法拿到路径中传递的客户id。

你需要的访问路径格式为/customers/{客户id值}，可以通过两种低改动量的方案实现，完全兼容现有类结构：

方案一：手动赋值（改动最小） #

1. 修正路由模板，使用清晰的无嵌套占位符定义，搭配整数路由约束避免路由冲突，替换原有路由写法为[Route("customers/{customerId:int}")]，最终生成的路由访问结构和要求完全一致。
2. 在动作方法中单独接收路由参数，手动赋值给嵌套对象属性：

   [HttpGet]
   [Route("customers/{customerId:int}")]
   public async Task<IActionResult> Details(int customerId, [FromQuery]CustomerDetails model)
   {
       // 初始化空的嵌套Customer对象，避免空引用
       model.Customer ??= new Customer();
       // 将路由拿到的id赋值给嵌套属性
       model.Customer.ID = customerId;
       // 原有业务逻辑无需调整
   }
   

方案二：自动绑定（无手动赋值代码） #

如果不想在动作方法中写手动赋值逻辑，可以通过显式标记绑定源的方式，让框架自动完成路由值到嵌套属性的映射：

1. 调整CustomerDetails类的定义，添加一个带显式路由绑定标记的中转属性：

   public class CustomerDetails
   {
       // 显式标记该属性从路由值customerId读取，自动同步到嵌套的Customer.ID
       [FromRoute(Name = "customerId")]
       public int CustomerRouteId
       {
           // 读取时直接获取嵌套对象的ID值
           get => Customer?.ID ?? 0;
           // 赋值时自动初始化嵌套Customer对象并写入ID
           set => Customer = new Customer() { ID = value };
       }
   
       public Customer Customer { get; set; }
       // 其他原有属性保持不变
   }
   

2. 保持动作方法的简化写法，无需额外手动传参：

   [HttpGet]
   [Route("customers/{customerId:int}")]
   public async Task<IActionResult> Details([FromQuery]CustomerDetails model)
   {
       // 此时model.Customer.ID已经自动从路由段获取了正确的值，其他查询串的属性也会正常绑定
       // 原有业务逻辑无需调整
   }
   

• 不要在路由模板里写带点的嵌套占位符（比如{customer.id}、{model.customer.id}），这类写法本质只是一个普通的路由段键名，和嵌套对象的层级没有任何映射关系，永远无法被默认模型绑定器识别。如果强制要使用带点的键名，需要自定义复杂的模型绑定器手动拆分键名映射属性，无实际收益，不推荐。
• 不要混淆不同的绑定源：[FromQuery]、[FromRoute]、[FromBody]是独立的绑定标记，一旦给某个属性标记了指定绑定源，框架就只会从对应的来源读值，不会跨源读取。之前给嵌套的Customer属性加[FromQuery]标注也无法解决问题，因为这个标记只是指定属性从查询串读值，和路由段的值没有绑定关系。

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