ASP.NET Core Web API多控制器用[Route("[Controller]")]遇Swagger报错

你的问题核心是：多个控制器使用[Route("[Controller]")]路由特性，通过基类继承[ApiController]时Swagger报错，但修改其中一个控制器路由为[Route("[Action]")]就正常，且希望保留控制器名作为路径前缀、不包含动作名。

可能的原因 #

1. [Controller]占位符解析时的潜在冲突（尽管代码中两个控制器路径不同，但Swagger元数据生成可能出现识别问题）
2. 基类[ApiController]特性与控制器路由的组合导致Swagger无法正确生成端点文档
3. 路由配置或Swagger配置的遗漏

具体解决方案 #

1. 显式指定路由前缀（替代[Controller]占位符） #

直接写死路由前缀，避免占位符解析的不确定性，确保路由明确：

// LicenseController.cs
[Route("license")] // 替换[Route("[Controller]")]
public class LicenseController : ApiController
{
    // ... 其他代码不变
}

// UsersController.cs
[Route("users")] // 替换[Route("[Controller]")]
public class UsersController : ApiController
{
    // ... 其他代码不变
}

2. 调整Swagger配置，明确控制器范围 #

在Program.cs的Swagger配置中，添加命名空间过滤，避免Swagger识别无关控制器：

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "你的API名称", Version = "v1" });
    // 仅包含指定命名空间下的控制器
    c.DocInclusionPredicate((docName, apiDesc) =>
    {
        var controllerNamespace = apiDesc.ActionDescriptor.EndpointMetadata
            .OfType<ControllerAttribute>()
            .FirstOrDefault()?.ControllerType.Namespace;
        return controllerNamespace == "Api.Controller";
    });
});

3. 全局应用[ApiController]（替代基类继承方式） #

在Program.cs顶部添加程序集特性，全局启用ApiController行为，去掉基类的[ApiController]：

[assembly: ApiController] // 放在Program.cs最顶部

var builder = WebApplication.CreateBuilder(args);
// ... 其他配置

同时修改基类：

// ApiControllerAttribute.cs
namespace Api.Controller;
using Microsoft.AspNetCore.Mvc;

// 移除[ApiController]特性
public class ApiController : ControllerBase
{
}

4. 明确动作方法的路由匹配 #

给LicenseController的HttpGet方法添加空路由模板，明确匹配控制器根路径：

[HttpGet("")] // 显式指定匹配控制器前缀的根路径
public ActionResult<List<PartialLicense>> Licenses([FromQuery] LicenseQuery query)
{
    // ... 其他代码不变
}

额外说明 #

你代码中关于“Parameterless constructor: because MS says so”的注释是误解——ASP.NET Core依赖注入完全支持带参数的构造函数，你的控制器构造写法是正确的，无需无参构造函数。

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