ASP.NET Core URL版本控制：多端点匹配异常问题求助

核心原因 #

你遇到的AmbiguousMatchException是因为路由系统无法通过API版本区分两个HttpGet端点：

• 虽然你在方法上标记了[MapToApiVersion]，但默认的ApiVersioning配置未启用URL路径段版本读取器，导致版本控制模块无法从URL的v{version}段识别版本号。
• 路由系统仅看到两个HttpGet方法的路由模板完全一致（都是api/v{version}/SomeController），因此判定为重复端点，抛出歧义异常。

解决步骤 #

1. 修改Startup.cs的API版本控制配置 #

添加UrlSegmentApiVersionReader，让系统从URL路径中解析版本号：

services.AddApiVersioning(config =>
{
    config.DefaultApiVersion = new ApiVersion(2.0);
    config.AssumeDefaultVersionWhenUnspecified = true;
    config.ReportApiVersions = true;
    // 关键配置：指定从URL路径段读取API版本
    config.ApiVersionReader = new UrlSegmentApiVersionReader();
});
// ASP.NET Core 3.0+推荐使用AddControllers替代AddMvc，更轻量化
services.AddControllers();

2. 验证控制器配置（已有配置无需修改） #

你的控制器路由和版本标记是正确的：

• 控制器级别的[Route("api/v{version:apiVersion}/[controller]")]定义了带版本号的路由模板
• [ApiVersion("1.0")]、[ApiVersion("2.0")]声明控制器支持的版本
• 方法上的[MapToApiVersion]将方法映射到对应版本

效果验证 #

修改配置后：

• 请求GET api/v1/SomeController?text=xxx会匹配GetSomethingV1
• 请求GET api/v2/SomeController?text=xxx会匹配GetSomethingV2
• 未指定版本的请求（如GET api/SomeController?text=xxx）会使用默认的2.0版本，匹配GetSomethingV2

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