为何Action方法中属性无法从查询字符串获取值？

在Razor视图中使用asp-route-*标签助手传递参数，Action方法的参数名称与标签助手属性完全一致，且为参数添加了[FromQuery]特性，但addressId和imageId始终为null。视图中的模型具备有效值，程序无异常抛出。

视图代码 #

<a type="button" class="btn btn-warning col-md-3 mt-3" 
   asp-controller="Company" 
   asp-action="Edit" 
   asp-route-id="@Model.Id" 
   asp-route-addressId="@Model.AddressId" 
   asp-route-imageId="@Model.ImageId">
    Edit Details
</a>

Action方法代码 #

public async Task<IActionResult> Edit([FromForm]CompanyEditViewModel model, [FromRoute]string id ,[FromQuery]string addressId, [FromQuery]string imageId) 
{
    //...
}

核心原因 #

asp-route-*标签助手的行为是：如果路由模板中定义了对应参数名，会将参数嵌入URL路径（路由参数）；如果路由模板中没有该参数，则自动转为URL查询字符串参数。你用[FromQuery]指定从查询字符串取值，若实际参数是作为路由参数传递的，就会导致绑定失败，参数为null。

具体解决方式 #

方式一：调整参数绑定特性（适配路由参数）

如果生成的URL是类似/Company/Edit/123/456/789这种格式（参数在路径中），将Action的[FromQuery]改为[FromRoute]，同时确保路由模板包含这两个参数：

// 在Program.cs/Startup.cs的路由配置中添加对应路由规则
app.MapControllerRoute(
    name: "companyEdit",
    pattern: "Company/Edit/{id}/{addressId?}/{imageId?}",
    defaults: new { controller = "Company", action = "Edit" });

修改后的Action参数：

public async Task<IActionResult> Edit([FromForm]CompanyEditViewModel model, [FromRoute]string id ,[FromRoute]string addressId, [FromRoute]string imageId) 
{
    //...
}

方式二：确保参数作为查询字符串传递（保留[FromQuery]）

如果希望参数以?addressId=xxx&imageId=yyy的形式出现在URL中：

1. 确认路由模板未定义addressId和imageId，此时asp-route-*会自动将它们转为查询参数
2. 验证模型的AddressId和ImageId属性确实有非空值
3. 检查参数类型是否匹配：比如模型中是Guid类型，Action参数用string会导致绑定失败，可将Action参数改为Guid?（允许空）或Guid
4. 查看页面源码，确认a标签的href属性包含正确的查询参数，示例：

   <a ... href="/Company/Edit/123?addressId=456&imageId=789">...</a>
   

方式三：直接构造查询字符串（备选方案）

如果标签助手自动生成不符合预期，可手动拼接查询参数：

<a type="button" class="btn btn-warning col-md-3 mt-3" 
   href="@Url.Action("Edit", "Company", new { id = Model.Id, addressId = Model.AddressId, imageId = Model.ImageId })">
    Edit Details
</a>

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