ASP.NET Core 8带可选参数的页面路由无法匹配部分请求

问题场景 #

定义的路由模板：

@page "/{countryCode}/{regionCode}/{cityName}/listing/{title?}/{address}/{uniqueId:Guid}"

期望匹配的两个请求：

/gb/eng/luton/listing/76-dunstable-road/d1b86843-f76d-4e81-a5b5-413e37ce0d1d

/gb/eng/luton/listing/some-title/76-dunstable-road/d1b86843-f76d-4e81-a5b5-413e37ce0d1d

对应的页面方法参数：

public async Task OnGetAsync(string countryCode, string regionCode, string cityName, string? title, string address, Guid uniqueId){...}

实际情况是第二个请求能正常匹配，但第一个请求无法匹配，需要排查原因。

问题原因 #

核心问题出在可选参数{title?}位于必填参数中间。当省略title时，路由解析器会按顺序匹配参数：

• 把76-dunstable-road分配给title（因为它是可选参数，允许非空值）
• 剩下的d1b86843-f76d-4e81-a5b5-413e37ce0d1d需要同时匹配address和uniqueId，但这个字符串是Guid格式，解析器无法将它拆分成两个有效参数，最终导致匹配失败。

解决方案 #

最直接可靠的办法是定义两个独立的路由模板，分别覆盖有title和无title的场景：

@page "/{countryCode}/{regionCode}/{cityName}/listing/{address}/{uniqueId:Guid}"
@page "/{countryCode}/{regionCode}/{cityName}/listing/{title}/{address}/{uniqueId:Guid}"

这样第一个请求会匹配第一个路由（自动将title设为null），第二个请求匹配第二个路由，两者都能正常解析参数。

也可以尝试给address添加格式约束（比如限制它不包含Guid格式的字符串），但这种方式灵活性差，不如拆分路由实用。

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