.NET 6 Web API：多基础路由与命名路由共存问题求助

你遇到的错误核心是：控制器上声明了两个基础路由模板（api/[controller] 和 api/v{version:apiVersion}/[controller]），每个HttpGet特性会与这两个基础路由分别组合，生成两个不同的完整路由模板，但你给它们指定了同一个路由名称（比如Route1）。而ASP.NET要求同一个路由名称必须对应完全一致的路由模板，因此触发冲突报错。

推荐采用以下两种方案，优先选择方案一（符合.NET 6 Web API最佳实践）：

方案一：通过API版本控制配置支持多版本传递方式，移除控制器多基础路由 #

这种方法无需在控制器上设置多个基础路由，而是通过配置API版本控制中间件，自动支持路径、查询字符串、请求头三种版本传递方式，同时避免路由名称冲突。

1. 配置API版本控制（Program.cs） #

builder.Services.AddApiVersioning(options =>
{
    options.DefaultApiVersion = new ApiVersion(1, 0);
    options.AssumeDefaultVersionWhenUnspecified = true;
    options.ReportApiVersions = true;
    // 同时启用三种版本传递方式
    options.ApiVersionReader = ApiVersionReader.Combine(
        new UrlSegmentApiVersionReader(),       // 路径方式：api/v1/helloworld
        new QueryStringApiVersionReader("api-version"), // 查询字符串方式：?api-version=1.0
        new HeaderApiVersionReader("api-version")       // 请求头方式：Header中携带api-version:1.0
    );
});

2. 调整控制器代码 #

将原单一方法拆分为多个方法，每个方法对应一个路由，避免通过switch判断路由名称的冗余逻辑，同时确保每个路由名称对应唯一模板：

[ApiVersion("1.0")]
[Route("api/[controller]")]
[ApiController]
public class HelloWorldController : ControllerBase 
{
    private readonly ICarRepository _repo;

    public HelloWorldController(ICarRepository repo)
    {
        _repo = repo;
    }

    [HttpGet("1", Name = "Route1")]
    public async Task<IActionResult> GetRoute1() 
    {
        var model = await _repo.FindByRoute1(...).ToListAsync();
        return Ok(model);
    }

    [HttpGet("2", Name = "Route2")]
    public async Task<IActionResult> GetRoute2() 
    {
        var model = await _repo.FindByRoute2(...).ToListAsync();
        return Ok(model);
    }

    [HttpGet("3", Name = "Route3")]
    public async Task<IActionResult> GetRoute3() 
    {
        var model = await _repo.FindByRoute3(...).ToListAsync();
        return Ok(model);
    }
}

方案二：保留多基础路由，给每个组合路由设置唯一名称 #

如果必须保留控制器上的两个基础路由，需要为每个基础路由与动作路由的组合设置唯一名称，避免名称冲突：

[ApiVersion("1.0")]
[Route("api/[controller]")]
[Route("api/v{version:apiVersion}/[controller]")]
[ApiController]
public class HelloWorldController : ControllerBase 
{
    private readonly ICarRepository _repo;

    public HelloWorldController(ICarRepository repo)
    {
        _repo = repo;
    }

    // 为两个不同基础路由的组合分别设置唯一名称
    [HttpGet]
    [Route("api/helloworld/1", Name = "Route1_Unversioned")]
    [Route("api/v{version:apiVersion}/helloworld/1", Name = "Route1_Versioned")]
    public async Task<IActionResult> GetRoute1() 
    {
        var model = await _repo.FindByRoute1(...).ToListAsync();
        return Ok(model);
    }

    [HttpGet]
    [Route("api/helloworld/2", Name = "Route2_Unversioned")]
    [Route("api/v{version:apiVersion}/helloworld/2", Name = "Route2_Versioned")]
    public async Task<IActionResult> GetRoute2() 
    {
        var model = await _repo.FindByRoute2(...).ToListAsync();
        return Ok(model);
    }

    [HttpGet]
    [Route("api/helloworld/3", Name = "Route3_Unversioned")]
    [Route("api/v{version:apiVersion}/helloworld/3", Name = "Route3_Versioned")]
    public async Task<IActionResult> GetRoute3() 
    {
        var model = await _repo.FindByRoute3(...).ToListAsync();
        return Ok(model);
    }
}

此方法会增加路由配置的冗余度，仅在特殊场景下使用。

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