.NET Core 8.0 Web API中Swagger加载失败及路由冲突问题求助

问题根源 #

不是内部类重复导致的。异常信息已明确指出核心问题：Conflicting method/path combination "GET WeatherForecast"——你的三个GET接口（原Get方法、新增的GetHouse和GetGarage）使用了完全相同的请求方法（GET）和路径（/WeatherForecast）。Swagger/OpenAPI 3.0要求每个API动作必须具备唯一的「方法+路径」组合，因此触发了文档生成错误。

解决办法 #

方法1：为新增API指定唯一路由路径 #

直接给GetHouse和GetGarage添加路由后缀，让它们的路径与原接口区分开：

[HttpGet("house", Name = "GetHouse")]
public House GetHouse()
{
    return new House();
}

[HttpGet("garage", Name = "GetGarage")]
public Garage GetGarage()
{
    return new Garage();
}

修改后三个接口的路径分别为/WeatherForecast、/WeatherForecast/house、/WeatherForecast/garage，满足唯一性要求。

方法2：修改原默认接口的路由 #

如果不想给新增接口加后缀，也可以调整原Get方法的路由：

[HttpGet("forecast", Name = "GetWeatherForecast")]
public IEnumerable<WeatherForecast> Get()
{
    // 原有业务逻辑
}

原接口路径变为/WeatherForecast/forecast，与另外两个接口路径明确区分。

方法3：通过Swagger配置解决冲突（不推荐） #

如果无法修改路由，可以在Swagger生成配置中添加冲突动作解析器，强制为冲突接口生成唯一标识。在Program.cs的Swagger配置段中添加：

builder.Services.AddSwaggerGen(c =>
{
    // 简单处理：取第一个冲突的动作
    c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());

    // 自定义处理：给路径追加动作名称
    /*
    c.ResolveConflictingActions(apiDescriptions =>
    {
        var targetAction = apiDescriptions.First();
        targetAction.RelativePath += $"-{targetAction.ActionDescriptor.Name}";
        return targetAction;
    });
    */
});

这种方法仅解决Swagger文档生成问题，实际API的路由冲突依然存在（客户端调用时会出现歧义），因此优先推荐前两种修改路由的方案。

额外优化：消除内部类重复 #

虽然内部类重复不是本次报错的原因，但可以提取公共类减少冗余代码：

// 提取为公共类
public class Dimensions
{
    public int Height { get; set; }
    public int Width { get; set; }
}

public class House
{
    public Dimensions dimensions { get; set; } = new Dimensions();
}

public class Garage
{
    public Dimensions dimensions { get; set; } = new Dimensions();
}

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