ASP.NET Core Razor Pages中a标签助手生成URL格式不符求助

核心原因 #

你遇到的URL格式异常，本质是Razor页面的路由模板配置错误，导致路由系统把本该作为查询字符串的参数解析成了URL路径的一部分，甚至因为路由模板的错误格式（比如错误使用&分隔路径参数），出现了参数值乱码拼接的情况。

解决步骤 #

1. 修正PaymentDetail页面的路由指令 #

打开PaymentDetail.cshtml，检查顶部的@page指令：

• 如果当前写成了类似@page "{year:int}&{month:int}"或@page "/Payments/PaymentDetail/{year}/{month}"这类带路径参数的格式，直接改成默认的无参数路由：

  @page
  

• 或者明确指定页面路由但不包含路径参数：

  @page "/Payments/PaymentDetail"
  

这样路由系统会自动将month和year作为查询字符串参数拼接在URL后，而不是嵌入路径中。

2. 优化前端参数传递代码 #

两种方式都可以正常生成预期URL：

方式一：直接使用asp-route-*属性

<a asp-page="/Payments/PaymentDetail" 
   asp-route-month="@Model?.Payments?.Paydate.Month" 
   asp-route-year="@Model?.Payments?.Paydate.Year">查看支付详情</a>

方式二：使用字典传递参数（确保路由模板正确的前提下）

@{
    var parms = new Dictionary<string, string>
    {
        { "month", Model?.Payments?.Paydate.Month.ToString() },
        { "year", Model?.Payments?.Paydate.Year.ToString() }
    };
}
<a asp-page="/Payments/PaymentDetail" asp-all-route-data="@parms">查看支付详情</a>

3. 排查全局路由配置 #

如果上述操作无效，检查Program.cs中的Razor页面路由配置，确保没有添加会强制将查询参数转为路径参数的自定义路由约定，比如类似以下的错误配置：

builder.Services.AddRazorPages(options =>
{
    // 避免这类会修改参数传递方式的自定义规则
    options.Conventions.AddPageRoute("/Payments/PaymentDetail", "{year}/{month}");
});

内容的提问来源于stack exchange，提问作者Wallace B. McClure