新增Post接口后Swashbuckle崩溃，如何解决？

问题原因 #

从错误信息能直接定位问题：你的CarsController里有两个POST方法都映射到了同一个路径api/Cars（分别是Create和CreateCars）。而OpenAPI 3.0规范要求HTTP方法+路径的组合必须唯一，这就导致Swagger生成文档时触发了NotSupportedException。

解决方案 #

这里提供两种实用的解决思路，你可以根据业务需求选择：

1. 给冲突方法设置唯一路由（推荐方案）

最规范且清晰的方式是给其中一个方法添加子路由，让两个接口的路径彻底区分开。比如给批量创建的接口加上bulk后缀：

[HttpPost("bulk")] // 路径变为 api/Cars/bulk，和原Create接口的api/Cars区分
public IActionResult CreateCars(List<Car> cars) {
    _carService.CreateCars(cars);
    return NoContent();
}

这样两个POST接口的路径不再重复，Swagger能正常生成文档，且两个接口都会在文档中展示，完全符合OpenAPI规范。

2. 配置Swashbuckle的冲突动作解析器（仅适用于无需展示所有冲突接口的场景）

如果不想修改路由结构，你可以通过Swashbuckle的配置强制处理冲突，让它只保留其中一个接口的文档。在你的配置文件（.NET 6+是Program.cs，老版本是Startup.cs）中修改SwaggerGen配置：

builder.Services.AddSwaggerGen(c =>
{
    // 遇到冲突时，仅保留第一个匹配的动作
    c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());
});

注意：这种方式会让其中一个接口不会出现在Swagger文档里，所以如果两个接口都需要对外暴露，优先选择第一种方案。

额外提示

你也可以检查下原Create方法的路由配置，确认它是否和CreateCars的路由完全重复。比如原Create方法可能是这样的：

[HttpPost]
public IActionResult Create(Car car) { ... }

这种单实体创建和批量创建的场景，用子路由区分是业内通用的清晰实践。

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