ASP.NET Web API版本兼容：同时支持两种版本读取器

完全可以同时支持UrlSegmentApiVersionReader和QueryStringApiVersionReader，这正是实现版本迁移向后兼容的标准方案，能解决你遇到的404问题。

1. 配置API版本服务 #

在ASP.NET Core的服务配置中，使用ApiVersionReader.Combine方法组合两种版本读取器，让系统优先尝试从URL段读取版本，若不存在则从查询参数读取。示例代码如下：

// Program.cs（ASP.NET Core 6+）
builder.Services.AddApiVersioning(options =>
{
    // 可选：在响应头返回支持的API版本信息
    options.ReportApiVersions = true;
    
    // 组合两种版本读取方式
    options.ApiVersionReader = ApiVersionReader.Combine(
        new UrlSegmentApiVersionReader(),
        // 这里的参数是查询参数名，默认是"api-version"，可根据你的旧配置调整
        new QueryStringApiVersionReader("api-version")
    );
    
    // 可选：设置未指定版本时的默认版本
    options.AssumeDefaultVersionWhenUnspecified = true;
    options.DefaultApiVersion = new ApiVersion(1, 0);
});

2. 控制器路由与版本标记 #

确保你的控制器通过[ApiVersion]标记支持的版本，并配置新的URL段路由。如果需要兼容完全不带版本的旧请求，也可以同时保留原路由：

[ApiController]
// 标记控制器支持的API版本
[ApiVersion("1.0")]
[ApiVersion("2.0")]
// 同时配置新旧路由，兼容不同请求方式
[Route("articles")]
[Route("v{version:apiVersion}/articles")]
public class ArticlesController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        // 可通过HttpContext.GetRequestedApiVersion()获取当前请求的版本
        var version = HttpContext.GetRequestedApiVersion();
        return Ok($"Articles list (Version: {version})");
    }
}

3. 解决404的核心逻辑 #

配置组合读取器后，系统会按顺序尝试读取版本号：

• 当请求为/v2/articles时，从URL段读取版本2.0，直接匹配对应路由；
• 当请求为/articles?api-version=2.0时，从查询参数读取版本2.0，API版本ing中间件会自动将请求映射到对应版本的路由端点，不会返回404。

注意事项 #

• 若你的旧查询参数不是默认的api-version（比如用的是version），需要在QueryStringApiVersionReader的构造函数中传入对应的参数名；
• 不需要单独维护两套控制器逻辑，同一个控制器通过[ApiVersion]标记多版本即可，若不同版本有差异逻辑，可使用[MapToApiVersion]标记特定版本的动作方法。

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