ASP.NET Core版本化Minimal API中Get/Delete方法返回异常问题

1. ApiVersionSet配置错误：你在Program.cs里错误地把NewApiVersionSet链式调用在MapCarter()之后，但MapCarter()返回的是IEndpointConventionBuilder，不是IEndpointRouteBuilder——这直接导致名为API_Version_Set的ApiVersionSet没被正确创建和注册。API版本化逻辑因此失效，当同一版本下多个端点用相同路由模板时，系统无法正确匹配GET/DELETE请求。

2. 参数绑定歧义：GET/DELETE方法的url参数没明确指定绑定源（默认会尝试从路由或查询字符串匹配），而PUT/POST/PATCH方法带了从请求体绑定的LoginDTO复杂类型参数。这种参数绑定的差异加上ApiVersionSet的配置错误，进一步加剧了端点匹配的混乱。

方案一：修正ApiVersionSet的创建方式 #

把Program.cs里的ApiVersionSet创建和MapCarter调用分开，确保在IEndpointRouteBuilder（也就是app对象）上直接调用NewApiVersionSet：

builder.Services.AddCarter()
    .AddEndpointsApiExplorer()
    .AddApiVersioning(options =>
{
    options.ReportApiVersions = true;
    options.DefaultApiVersion = ApiVersions.v1;
    options.AssumeDefaultVersionWhenUnspecified = true;
    options.ApiVersionReader = new UrlSegmentApiVersionReader();
}).AddApiExplorer(options =>
{
    options.GroupNameFormat = "'v'VVV";
    options.SubstituteApiVersionInUrl = true;
});

var app = builder.Build();

// 先正确创建ApiVersionSet
var apiVersionSet = app.NewApiVersionSet(ApiVersions.vset)
    .HasApiVersion(ApiVersions.v1)
    .HasApiVersion(ApiVersions.v2)
    .HasApiVersion(ApiVersions.v3)
    .ReportApiVersions()
    .Build();

// 再映射Carter路由
app.MapCarter();

app.Run();

方案二：明确参数绑定源 #

给GET/DELETE方法的url参数加上[FromRoute]特性，让系统明确知道从路由中获取这个参数，消除绑定歧义：

public static string GetMethod([FromRoute] string? url) => "This is from GET";
public static string DeleteMethod([FromRoute] string? url) => "this is from DELETE.";

方案三：区分路由模板（可选） #

如果不想改参数，也可以给PUT/POST/PATCH方法换个路由模板，避免和GET/DELETE的完全重复：

group.MapPut("items/{url}", PutMethod).HasApiVersion(ApiVersions.v1);
group.MapPost("items/{url}", PostMethod).HasApiVersion(ApiVersions.v1);
group.MapPatch("items/{url}", PatchMethod).HasApiVersion(ApiVersions.v1);

验证 #

按方案一+方案二调整后，GET/DELETE就能正常返回预期内容，同时PUT/POST/PATCH的功能也不受影响。

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