.NET Core同一控制器多路由（含/无版本）失效问题求解

首先，你当前的控制器路由写法本身是合法的，但出现500错误大概率是控制器方法内部的逻辑异常（比如空引用、依赖未注入、参数处理错误等），建议先查看服务器日志定位具体错误原因。

如果要确保双路由正常工作，以下是几种可行方案：

方案1：保留控制器多Route属性，排查内部异常 #

控制器上同时标记多个[Route]属性是ASP.NET Core允许的写法，每条属性对应一条独立路由。你需要：

• 启用详细错误日志，查看500错误的具体堆栈信息，定位方法内的问题（比如异步方法未正确处理、参数绑定失败等）
• 确保GetAsync方法的参数绑定逻辑在两条路由下都能正常工作（比如没有依赖路由参数的必填项）

方案2：用单个Route属性实现可选版本段 #

将两条路由合并为一个带可选参数的路由模板，通过正则限制版本格式，避免重复标记Route属性：

[ApiController]
// 匹配api/docs或api/vX.X/docs格式的路径
[Route("api/{version:regex(^v\\d+\\.\\d$)?}/docs")]
public class DocsController : ControllerBase
{
    [HttpGet]
    public async Task<IActionResult> GetAsync(...)
    {
        // 方法逻辑保持不变
    }
}

这里的regex(^v\\d+\\.\\d$)?表示版本段是可选的，且必须符合vX.X的格式（比如v1.0、v2.1）。

方案3：手动映射路由（适合复杂场景） #

在Program.cs（ASP.NET Core 6+）或Startup.cs中手动为同一方法映射两条路由，这种方式更灵活：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();

var app = builder.Build();

app.UseHttpsRedirection();
app.UseAuthorization();

// 手动映射两条路由到DocsController的GetAsync方法
app.MapGet("api/docs", async (DocsController controller, [FromQuery] ...) =>
    await controller.GetAsync(...));

app.MapGet("api/v1.0/docs", async (DocsController controller, [FromQuery] ...) =>
    await controller.GetAsync(...));

app.MapControllers();
app.Run();

注意这种方式需要手动处理方法的参数绑定（比如查询参数、路由参数），适合需要自定义路由逻辑的场景。

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