使用泛型基类控制器继承后Swagger报方法/路径冲突错误如何解决

错误原因 #

你遇到的SwaggerGeneratorException冲突是因为Swagger生成器未正确区分不同泛型子类控制器继承的同名Action路径，而你之前使用的ResolveConflictingActions方案会强制合并多个冲突接口的参数，导致请求路由匹配异常，是调用长时间卡住的核心原因，该配置需先删除。

修复步骤 #

步骤1：修正重复路由配置 #

你当前的路由规则存在重复声明：

• 控制器类上已经通过[Route("api/odata/[controller]/[action]")]声明了路径模板，包含控制器名和Action名
• Action方法上额外加的[Route("Get")]属于多余配置，会导致路径变成api/odata/[controller]/[action]/Get，反而引发路由异常

直接删除基类Get方法上的[Route("Get")]特性即可，最终生成的路径会天然唯一：

• Employee控制器Get接口路径：api/odata/Employee/Get
• Company控制器Get接口路径：api/odata/Company/Get

步骤2：添加Swagger操作过滤器（可选，若第一步后仍有冲突） #

创建自定义操作过滤器，强制Swagger为每个接口生成唯一标识：

public class SwaggerOperationFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        // 拼接控制器名+原有OperationId作为全局唯一标识
        operation.OperationId = $"{context.MethodInfo.DeclaringType?.Name}_{operation.OperationId}";
    }
}

在Startup.cs的Swagger配置中注册过滤器：

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "PAM_System.ODataWebService", Version = "v1" });
    // 注册自定义过滤器
    c.OperationFilter<SwaggerOperationFilter>();
});

步骤3：清理重复的服务与路由注册（解决调用卡住问题） #

你当前Startup.cs中存在重复注册和路由体系冲突问题，需合并重复配置：

1. 合并三次重复的AddControllers注册，保留一份即可：

// 删掉原来的三个独立AddControllers，替换为下面的合并配置
services.AddControllers(mvcOptions =>
{
    mvcOptions.EnableEndpointRouting = false;
})
.AddOData(opt => 
{
    opt.Count().Filter().Expand().Select().OrderBy().SetMaxTop(100);
    opt.AddRouteComponents("api/odata", SingletonEdmModel.GetEdmModel());
});

2. 删掉Configure方法中的app.UseEndpoints配置，你已经关闭了端点路由，保留app.UseMvc即可，避免两套路由体系冲突。

验证 #

完成上述修改后重新运行项目：

• Swagger页面会正常显示两个业务控制器下独立的Get接口
• 分别调用两个接口可正常返回对应业务数据，无卡顿问题

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