ASP.NET Core属性路由：如何匹配含双斜杠的空路径段？

默认情况下，ASP.NET Core的路由系统确实不会直接匹配空的URL路径段，这里有两个核心原因：

• 你的路由模板{groupImportId?}里的?表示该路径段可以不存在，而不是“存在但为空值”。当你请求//这种连续斜杠的URL时，默认的URL规范化会把连续斜杠合并成单个斜杠，最终请求路径会变成/api/group/ruleParts，这个路径并不符合{groupImportId?}/ruleParts的模板（因为少了一个路径段）。
• 即使关闭了URL规范化，路由系统也不会默认将空的路径段绑定到可选参数上，因为它默认要求路径段要么有实际值，要么完全不存在。

解决方法 #

1. 添加多路由覆盖两种场景

最简单的方式是给你的Action添加两个路由属性，分别处理「带路径段（包括空段）」和「不带路径段」的情况：

[Route("/api/[controller]")]
public class GroupController : ControllerBase
{
    // 匹配 /api/group/xxx/ruleParts 或 /api/group//ruleParts（空路径段）
    [HttpPut("{groupImportId:minlength(0)}/ruleParts")]
    // 匹配 /api/group/ruleParts（无路径段）
    [HttpPut("ruleParts")]
    public async Task<IActionResult> PutRuleParts(string groupImportId = null, [FromBody]List<RulePartDto> ruleParts)
    {
        // 统一处理空字符串和null的情况
        groupImportId = string.IsNullOrWhiteSpace(groupImportId) ? null : groupImportId;
        
        // 你的业务逻辑代码
        return Ok();
    }
}

这里的minlength(0)约束是关键，它告诉路由系统允许该路径段为空字符串，这样//的情况就能被匹配到，参数groupImportId会被赋值为空字符串，再通过代码统一转换成null即可。

2. 关闭URL规范化（可选）

如果你需要保留原始的//URL格式（不希望被合并成单个斜杠），可以在Program.cs中配置路由选项，关闭URL规范化的相关行为：

var builder = WebApplication.CreateBuilder(args);

// 配置路由选项，关闭URL规范化
builder.Services.Configure<RouteOptions>(options =>
{
    // 禁止合并连续斜杠
    options.SuppressPathMatchingMiddleware = true;
    // 其他路由配置...
});

// 后续的中间件配置...
var app = builder.Build();

关闭后，http://localhost/api/group//ruleParts会以原始路径进入路由系统，此时只需要使用带minlength(0)约束的路由模板就能匹配到这个请求。

3. 使用自定义路由约束（进阶）

如果需要更复杂的匹配逻辑，可以自定义路由约束，但对于这个场景来说，上面的方法已经足够简洁实用，一般不需要额外自定义约束。

验证 #

配置完成后，你可以测试三种请求场景：

• http://localhost/api/group/abc123/ruleParts：正常匹配，groupImportId为abc123
• http://localhost/api/group//ruleParts：匹配第一个路由，groupImportId被处理为null
• http://localhost/api/group/ruleParts：匹配第二个路由，groupImportId为null

这样就能覆盖你需要的所有情况了。

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