.NET 6 ASP.NET Core Web API添加ApiVersion后遇500错误求助

你遗漏了API版本化服务的配置步骤，虽然安装了相关NuGet包，但未在Program.cs中注册API版本服务，导致路由系统无法识别apiVersion约束。

具体配置步骤： #

在Program.cs中添加以下代码，注册API版本化服务：

// 注册API版本化核心服务
builder.Services.AddApiVersioning(options =>
{
    // 可选：响应头中返回支持的API版本信息
    options.ReportApiVersions = true;
    // 可选：当未指定版本时使用默认版本
    options.AssumeDefaultVersionWhenUnspecified = true;
    options.DefaultApiVersion = new ApiVersion(1, 0);
});

// 如果需要API Explorer支持（比如生成Swagger文档），添加以下配置
builder.Services.AddVersionedApiExplorer(options =>
{
    options.GroupNameFormat = "'v'VVV";
    options.SubstituteApiVersionInUrl = true;
});

说明： #

• AddApiVersioning方法会自动将apiVersion约束注册到RouteOptions.ConstraintMap，这正是解决你遇到的约束未解析问题的关键。
• 你的控制器路由[Route("api/v{version:apiVersion}/[controller]")]写法正确，完成上述配置后即可正常解析apiVersion参数。

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