.NET 7 Razor Pages路由约定失效，路由值无法绑定变量

直接修复方案 #

你遇到的核心问题是Razor Pages默认不会自动将GET请求的路由参数绑定到PageModel的公共属性上，需要显式配置：

方法1：使用[BindProperty(SupportsGet = true)]特性

修改PageModel代码，给需要绑定的属性添加特性：

public class IndexModel : PageModel
{
    [BindProperty(SupportsGet = true)]
    public string? SourceIATA { get; set; }
    
    [BindProperty(SupportsGet = true)]
    public string? DestinationIATA { get; set; }
}

方法2：通过OnGet方法参数接收

直接在OnGet方法中声明对应参数，框架会自动完成绑定：

public class IndexModel : PageModel
{
    public string? SourceIATA { get; set; }
    public string? DestinationIATA { get; set; }

    public void OnGet(string? sourceIATA, string? destinationIATA)
    {
        SourceIATA = sourceIATA;
        DestinationIATA = destinationIATA;
    }
}

排查方向 #

如果修复后仍有问题，可以从以下几点逐一排查：

• 自定义路由约定影响：你配置了RouteTemplateModelConventionRazorPages自定义路由约定，需要确认该约定是否修改了路由参数的命名、匹配规则，比如是否因为小写URL配置导致参数名称映射异常。
• 请求本地化中间件冲突：你使用了RouteSegmentRequestCultureProvider，该提供器会从路由段中解析文化代码，可能和你的SourceIATA/DestinationIATA参数位置冲突。可以暂时移除该提供器测试，或者调整路由模板，将文化段放在最前面（如@page "/{culture?}/flights/{SourceIATA?}/{DestinationIATA?}"）。
• 路由参数匹配验证：启用路由诊断日志，查看参数是否被正确提取。在Program.cs中添加日志配置：

builder.Logging.AddFilter("Microsoft.AspNetCore.Routing", LogLevel.Debug);

运行后查看调试日志，确认路由匹配时是否正确识别了SourceIATA和DestinationIATA参数及其对应值。

• 参数名称拼写检查：确保PageModel属性名称和路由模板中的参数名称拼写完全一致（Razor Pages路由参数匹配不区分大小写，但拼写错误会直接导致绑定失败）。

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