使用AddPageRoute后Razor Pages链接Tag Helper失效问题求助

问题原因 #

你配置的两个路由中，第二个路由依赖productCode2参数，同时OnGet方法里productCode2是必填的int类型。当仅传递productCode1时，路由系统找不到满足所有参数要求的匹配路由（productCode2缺失），因此Tag Helper无法生成有效链接。

解决方案 #

1. 将productCode2设为可选参数 #

修改OnGet方法的参数，把productCode2改为可空类型或设置默认值，确保没有传递该参数时方法仍能正常匹配：

public async Task<IActionResult> OnGet(int productCode1, int? productCode2 = null)
{
    return Page();
}

2. 优化路由配置（可选） #

为让路由系统更清晰识别可选参数，可在第二个路由的参数后添加?标记其为可选：

builder.Services.AddRazorPages()
    .AddRazorPagesOptions(options =>
    {
        options.Conventions.AddPageRoute("/Product", "/product/code-{productCode1}");
        // 标记productCode2为可选参数
        options.Conventions.AddPageRoute("/Product", "/product/code-{productCode1}/code-{productCode2?}");
    });

验证效果 #

现在使用仅带productCode1的Tag Helper：

<a asp-page="/Product" asp-route-productCode1="6" >link</a>

会正确生成链接：https://localhost:1898/product/code-6

带两个参数的链接依然正常生成：https://localhost:1898/product/code-6/code-18

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