ASP.NET Core Razor Pages旧URL映射至新页面的实现咨询

阿华AIGC实验室

2026-5-20

嘿，我之前也踩过这个坑！在ASP.NET Core Razor Pages里做URL映射/重定向，光在ConfigureServices里配置确实不会生效——因为这类路由规则是要在请求处理管道里设置的，给你几个靠谱的实现方法：

方案1：使用URL重写中间件（最通用）

这是处理旧URL映射最灵活的方式，不管旧URL是什么结构都能适配。

先确保ConfigureServices里已经注册了Razor Pages服务（默认项目已经包含，没的话加上）：

services.AddRazorPages();

关键步骤在Configure方法里，要把重写规则放在UseRouting之后、UseEndpoints之前：

app.UseRouting();

// 配置重写规则，这里假设你的旧URL是 /OldTest?OldParam={xxx}
var rewriteOptions = new RewriteOptions()
    // 正则捕获旧参数，替换到新URL里
    .AddRewrite(@"^OldTest\?OldParam=(.*)", "MyNewPage?handler=Test&MyParam=$1", skipRemainingRules: true);

app.UseRewriter(rewriteOptions);

app.UseEndpoints(endpoints =>
{
    endpoints.MapRazorPages();
});

如果你的旧URL是固定的（比如不带参数的/OldPage），可以直接用更简单的重定向：

.AddRedirect("/OldPage", "/MyNewPage?handler=Test&MyParam=abc")

注意：正则表达式可以根据你的实际旧URL结构调整，测试的时候可以用工具验证正则是否匹配。

方案2：给页面添加备用路由模板

如果旧URL是类似/MyOldPage的页面路径，不想用中间件的话，可以直接在页面模型上添加路由属性：

[PageName("MyNewPage")]
[Route("/MyOldPage")] // 旧URL路径
[Route("/MyNewPage")] // 原有的URL路径
public class MyNewPageModel : PageModel
{
    public IActionResult OnGetTest(string MyParam)
    {
        // 你的业务逻辑代码
        return Page();
    }
}

这样访问/MyOldPage?handler=Test&MyParam=abc就会直接命中这个页面的Test handler，完全不需要额外的重写配置。不过这个方式只适合旧URL是页面路径的场景，带复杂参数的话还是方案1更合适。

为什么之前在ConfigureServices里配置没生效？

Razor Pages的ConfigureServices主要是用来注册服务、配置全局路由选项（比如小写URL、后缀等），而具体的URL映射/重定向属于请求管道的处理逻辑，必须在Configure方法里通过中间件（比如URL重写）或者端点路由来设置，所以之前的配置才没起作用。

最后提个小建议：测试的时候记得清浏览器缓存，或者用隐私窗口打开，避免旧的缓存URL影响测试结果哦！

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