Asp.Versioning.Http AmbiguousMatchException：请求与控制器上的多个端点匹配

Question

我正在尝试使用 Asp.Versioning.Http package 版本 6.4.0 在我的控制器上实现基于 header 的版本控制它应该在这里非常简单但是我得到AmbiguousMatchException: The request matched multiple endpoints exception

这是我的程序 class

我的控制器是这样定义的：

    var builder = WebApplication.CreateBuilder(args);
    // Add services to the container.
    builder.Services.AddControllers();

    // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
    builder.Services.AddEndpointsApiExplorer();
    builder.Services.AddApiVersioning(options => {
       // options.ApiVersionReader = new HeaderApiVersionReader("api-version");
        options.DefaultApiVersion = new ApiVersion(1.0);
        options.AssumeDefaultVersionWhenUnspecified = true;
        options.ReportApiVersions = true;
    }).EnableApiVersionBinding();
    builder.Services.AddMvc();
    builder.Services.AddSwaggerGen();

    var app = builder.Build();

    // Configure the HTTP request pipeline.
    if (app.Environment.IsDevelopment())
    {
       // app.UseSwagger();
        //app.UseSwaggerUI();
    }

    app.UseHttpsRedirection();
    app.UseRouting();
    app.UseAuthorization();
    app.MapHealthChecks("/health/live");
    app.MapControllers();
    app.Run();

   namespace Things.Service.Controllers.V1
   {
    [ApiController]
    [ApiConventionType(typeof(DefaultApiConventions))]
    [Route("[controller]")]
    [Asp.Versioning.ApiVersion(1.0)]
    public class ThingsController : ControllerBase
    {
       // controller logic
    }
   }

    namespace Things.Service.Controllers.V2
    {
    [ApiController]
    [ApiConventionType(typeof(DefaultApiConventions))]
    [Route("[controller]")]
    [Asp.Versioning.ApiVersion(2.0)]`your text`
    public class ThingsController : ControllerBase
     {
       // controller logic
     }
    }

我得到这个例外：

    Microsoft.AspNetCore.Routing.Matching.AmbiguousMatchException: The request matched multiple    endpoints. Matches: 

Things.Service.Controllers.V2.ThingsController.GetAllAsync (Things.Service)
Things.Service.Controllers.V1.ThingsController.GetAllAsync (Things.Service)

Answer 1

发生这种情况是因为您缺少AddMvc 。 别被名字骗了，这增加了 MVC 核心，而不是完整的 MVC 堆栈。 从6.0开始，新设置以IApiVersioningBuilder为中心，以便所有设置都在一个地方，并且希望更容易遵循。 如果您来自较早的版本（例如 <= 5.x ），这可能会让您大吃一惊。 此更改是必要的，因为AddApiVersioning现在是Minimal APIs的基础，它不包括 MVC Core 或 controller 支持。 AddMvc添加了这些功能。

         
services
 .AddApiVersioning()     // Asp.Versioning.Http : Core services and Minimal APIs
 .AddMvc()               // Asp.Versioning.Mvc : MVC Core
 .AddApiExplorer()       // Asp.Versioning.Mvc.ApiExplorer : API Explorer
 .AddOData()             // Asp.Versioning.OData : OData support
 .AddODataApiExplorer(); // Asp.Versioning.OData.ApiExplorer : OData API Explorer

由于您使用的是 MVC 核心和控制器，因此不需要EnableApiVersionBinding 。 MVC Core 支持Model Binders 。 AddMvc将注册所有这些服务。 如果你想在你的 controller 操作中接收传入的ApiVersion ，你只需要添加一个ApiVersion类型的参数和你选择的名称。 例如：

namespace Things.Service.Controllers.V1
{
   [ApiVersion(1.0)]
   [ApiController]
   [ApiConventionType(typeof(DefaultApiConventions))]
   [Route("[controller]")]
   public class ThingsController : ControllerBase
   {
      [HttpGet]
      public IActionResult Get(ApiVersion version) => Ok();
   }
}

最小 API无法支持这种类型的 model 绑定。 EnableApiVersionBinding提供了一种使其工作的方法。 如果你添加了它，它不会伤害任何东西，但这是不必要的。

最后，您似乎在命名空间中包含了版本号。 如果这确实是您的设置，您可以考虑使用VersionByNamespaceConvention 。 这将不需要用[ApiVersion]装饰控制器。 API 版本将派生自名称空间本身。 有关其他详细信息，请参阅Version By Namespace Convention文档。