.NET 8中asp-route-memberId生成查询参数而非路由参数的疑问

AI 小北

2026-6-24

问题

在ASP.NET Core 5中，使用asp-route-...可以生成类似/Member/Update/2的URL，但升级到.NET 8.0后，生成的URL变成了/Member/Update?memberId=2。我不清楚.NET 8.0做了哪些变更，导致必须在[HttpGet]中指定[HttpGet("Update/{memberId}")]才能生成路由式URL，感觉是不是漏了什么配置？是我记错了旧版本的行为，还是新版本确实修改了这个逻辑？有没有其他方法可以改回原来的URL生成方式？

我的路由配置：

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

我的Index视图代码：

<td class="d-flex justify-content-center">
    <a asp-action="Info" asp-route-memberId="@item.Id" class="btn btn-info btn-rounded btn-fw px-4 py-2 mx-1">View</a>
    <a asp-action="Update" asp-route-memberId="@item.Id" class="btn btn-warning btn-rounded btn-fw text-white px-4 py-2 mx-1">Update</a>
    <a asp-action="SafeDelete" asp-route-memberId="@item.Id" class="btn btn-danger btn-rounded btn-fw px-4 py-2 mx-1">Delete</a>
</td>

我的控制器代码：

[HttpGet]
public async Task<IActionResult> Update([FromRoute]int memberId)
{
    var member = await _memberRepository.GetNonDeletedMemberById(memberId);
    var updateMemberVM = _mapper.Map<UpdateMemberVM>(member);

    return View(updateMemberVM);
}

回答

这确实是.NET 6及以后版本（包括.NET 8）路由系统的行为变更，不是你记错了旧版本的逻辑。

1. 变更原因

在ASP.NET Core 5及更早版本中，路由系统会对asp-route-*的参数做宽松匹配：即使参数名称和默认路由模板里的{id?}占位符不一致，框架也会自动将参数嵌入URL路径。但从.NET 6开始，路由匹配逻辑变得严格：只有当参数名称和路由模板中的占位符名称完全一致时，才会将参数放入URL路径；否则会自动降级为查询字符串参数。

你的默认路由模板是{controller=Home}/{action=Index}/{id?}，占位符名称是id，但你传递的参数是memberId，名称不匹配，所以.NET 8会生成带查询字符串的URL。

2. 解决方法

有三种方式可以恢复旧的URL生成行为：

方法一：修改全局默认路由模板

把默认路由里的{id?}替换成{memberId?}（如果该参数名称是项目全局通用的）：

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{memberId?}");

这样asp-route-memberId就能匹配到路径占位符，生成/Member/Update/2格式的URL。

方法二：为控制器方法添加路由属性

就是你提到的，给目标方法指定具体路由模板：

[HttpGet("Update/{memberId}")]
public async Task<IActionResult> Update([FromRoute]int memberId)
{
    // 原有逻辑不变
}

这种方式更灵活，适合单个控制器方法的自定义路由，不会影响全局路由规则。

方法三：统一参数与占位符名称

在视图中使用和默认路由占位符一致的id参数：

<a asp-action="Update" asp-route-id="@item.Id" class="btn btn-warning btn-rounded btn-fw text-white px-4 py-2 mx-1">Update</a>

同时修改控制器方法的参数名称：

[HttpGet]
public async Task<IActionResult> Update([FromRoute]int id)
{
    var member = await _memberRepository.GetNonDeletedMemberById(id);
    // 后续逻辑不变
}

这种方式无需修改路由模板，完全沿用默认路由规则。

3. 额外说明

.NET 6+的路由调整是为了提升匹配的确定性和性能，避免模糊匹配带来的意外行为。如果项目中有大量类似参数不匹配的场景，优先考虑方法一或方法三，能减少重复的路由属性配置。

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