Razor Pages使用@page指令路由时链接异常改写的问题求助

问题原因 #

你遇到的是Razor Pages路由系统的默认行为：当页面路由包含可选参数（比如{id:int?}）时，生成链接时如果没有显式指定参数值，系统会自动复用当前请求上下文里已有的路由参数值。访问过/index/1后，上下文里保留了id=1，所以后续生成首页链接时会自动带上这个参数，导致链接变成~/1。

解决方法 #

方法一：生成链接时显式清除id参数 #

在首页的链接标签中，通过asp-route-id=""强制清空id参数，确保生成的链接是无参数的首页路径：

<a asp-page="/Index" asp-route-id="">首页</a>

或者使用asp-all-route-data来移除指定参数：

<a asp-page="/Index" asp-all-route-data='new Dictionary<string, string> { ["id"] = null }'>首页</a>

方法二：配置路由约定，优先匹配无参数路径 #

在Program.cs中为Index页面添加多个路由模板，让无参数的路由优先匹配，同时保留带id的路由：

builder.Services.AddRazorPages(options =>
{
    // 优先匹配无参数的首页路由
    options.Conventions.AddPageRoute("/Index", "");
    // 带可选id参数的路由
    options.Conventions.AddPageRoute("/Index", "{id:int?}");
});

这种方式可以确保系统生成首页链接时，默认使用无参数的路由模板，避免复用之前的id值。

说明 #

你的操作本身没有错误，Razor Pages的路由确实是“开箱即用”的，但这种参数复用是默认设计行为，针对带可选参数的页面，需要通过上述方式显式处理，才能保证链接生成符合预期。

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