Razor Page头部链接保留ID路由值问题及最佳实践咨询

我在学习Contoso U教程时遇到了Razor Pages路由参数的问题：

• 布局文件里的讲师列表导航链接代码如下：

  <li class="nav-item">
    <a class="nav-link text-dark"
       asp-area=""
       asp-page="/Instructors/Index">Instructors</a>
  </li>
  

  正常渲染后对应的URL是https://localhost:7283/Instructors。
• 讲师列表页中，选择单名讲师的链接代码是：

  <a asp-page="./Index" asp-route-id="@item.ID">Select</a>
  

  渲染后URL为https://localhost:7283/Instructors/1。

当我处于带ID的讲师详情页面时，点击导航栏的Instructors链接，预期会回到不带ID的讲师列表页，但实际生成的URL仍然带有ID，没有被清除。查资料发现这是因为Razor Pages的Tag Helper会保留环境值（ambient values），自动把当前请求中的路由参数附加到新生成的链接里。

请问这种情况有什么最佳实践？目前我能想到的办法是放弃Tag Helper，直接用原生HTML锚点标签。

1. 显式清除目标路由参数 #

在导航链接的Tag Helper中，通过asp-route-id=""显式指定ID参数为空，强制覆盖环境值：

<li class="nav-item">
  <a class="nav-link text-dark"
     asp-area=""
     asp-page="/Instructors/Index"
     asp-route-id="">Instructors</a>
</li>

这样生成的链接会忽略当前的ID参数，直接指向/Instructors。这是官方推荐的最直接的解决方案。

2. 重置所有路由参数 #

如果需要清除多个路由参数，可以创建一个空的路由数据字典，通过asp-all-route-data覆盖所有环境值：

@{
    var emptyRouteData = new Dictionary<string, string>();
}
<li class="nav-item">
  <a class="nav-link text-dark"
     asp-area=""
     asp-page="/Instructors/Index"
     asp-all-route-data="emptyRouteData">Instructors</a>
</li>

这种方式适合页面存在多个路由参数，需要一次性全部清除的场景。

3. 使用原生HTML锚点标签 #

正如你想到的，直接编写原生<a>标签，明确指定目标URL，完全绕开Tag Helper的环境值机制：

<li class="nav-item">
  <a class="nav-link text-dark" href="/Instructors">Instructors</a>
</li>

如果应用部署在子路径下，建议用Url.Content()生成正确路径，避免硬编码路径的问题：

<a class="nav-link text-dark" href="@Url.Content("~/Instructors")">Instructors</a>

4. 配置可选路由参数（复用页面场景） #

如果讲师列表和详情共用同一个页面模型，可以在页面的@page指令中将ID设为可选参数：

// Instructors.cshtml
@page "{id:int?}"

然后在页面模型的OnGet方法中根据ID是否存在处理不同逻辑：

public IActionResult OnGet(int? id)
{
    if (id == null)
    {
        // 加载并返回讲师列表
    }
    else
    {
        // 加载并返回指定讲师的详情
    }
}

不过这种方式仍需要配合方法1来清除导航链接的环境值，确保点击时能回到无ID的列表状态。

Razor Pages的环境值机制本意是简化同页面/同区域内的路由参数传递，减少重复代码，但在需要重置参数的跨场景导航中会出现这种“意外”保留参数的情况。显式覆盖参数的方式比原生标签更适配ASP.NET Core的路由系统，能自动处理区域、子路径等复杂场景，是更推荐的最佳实践。

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