为何Swagger判定不同名称路由的API存在歧义？Name属性为何无效？

为什么Name属性无法解决Swagger的歧义异常？ #

Name属性的作用是给路由命名，方便在代码中通过Url.Link或Url.RouteUrl生成对应路由的URL，它根本不是用来判定Action唯一性的标识。Swagger生成OpenAPI文档时，判定Action是否唯一的依据是HTTP方法 + 路由模板 + 参数签名的组合，和Name属性完全无关。

你的代码问题出在哪？ #

你把[HttpGet]和[Route]分开标注在方法上，这种写法会导致Swagger解析时无法正确关联HTTP方法和路由模板，进而误以为两个Action的请求标识存在歧义。虽然你给两个方法设置了不同的绝对路由（/TestRouteA、/TestRouteB），但分开的属性标注干扰了Swagger的识别逻辑。

解决办法 #

把HTTP方法和路由合并到同一个属性中，替换原来分开的[HttpGet]和[Route]：

[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
    private static readonly string[] Summaries = new[]
    {
        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
    };

    private readonly ILogger<WeatherForecastController> _logger;

    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }

    [HttpGet("/TestRouteB", Name = "TestB")]
    public IEnumerable<WeatherForecast> GetWeatherB([FromQuery] QueryParameters queryParam)
    {
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        }).ToArray();
    }

    [HttpGet("/TestRouteA", Name = "TestA")]
    public IEnumerable<WeatherForecast> GetWeatherA([FromQuery] QueryParameters queryParam)
    {
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        }).ToArray();
    }
}

这样Swagger能清晰识别每个Action对应的HTTP方法和唯一路由，歧义异常自然消失，同时你也能保留Name属性用于路由命名。

补充说明 #

你提到移除Name属性能解决问题，本质是因为移除后Swagger退而求其次，用方法名称（GetWeatherA、GetWeatherB）作为临时的唯一标识，但这不是规范的解决方式，合并HTTP方法与路由的写法才是符合ASP.NET Core和Swagger解析逻辑的正确做法。

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