单Web API项目中能否配置多个含Login控制器的Swagger端点？

完全可以在单个ASP.NET Web API项目里实现你的需求——三个独立的Swagger端点，分别对应example.com/Users、example.com/Products、example.com/Sales前缀，且每个端点都包含Login控制器，不需要拆分成三个项目。以下是具体实现步骤：

实现步骤 #

1. 给控制器添加路由前缀与Swagger分组 #

给不同业务控制器设置专属路由前缀，同时让Login控制器加入三个Swagger分组，确保它出现在每个端点的文档里：

// 用户管理控制器
[ApiController]
[Route("Users/[controller]")]
[ApiExplorerSettings(GroupName = "Users")]
public class UsersController : ControllerBase 
{
    // 控制器逻辑
}

// 产品管理控制器
[ApiController]
[Route("Products/[controller]")]
[ApiExplorerSettings(GroupName = "Products")]
public class ProductsController : ControllerBase 
{
    // 控制器逻辑
}

// 客户购买控制器
[ApiController]
[Route("Sales/[controller]")]
[ApiExplorerSettings(GroupName = "Sales")]
public class SalesController : ControllerBase 
{
    // 控制器逻辑
}

// Login控制器（加入三个分组，支持多前缀访问）
[ApiController]
[Route("{group}/[controller]")]
[ApiExplorerSettings(GroupName = "Users")]
[ApiExplorerSettings(GroupName = "Products")]
[ApiExplorerSettings(GroupName = "Sales")]
public class LoginController : ControllerBase 
{
    // 登录逻辑
}

Login控制器的路由参数{group}会自动匹配三个前缀，可通过/Users/Login、/Products/Login、/Sales/Login分别访问。

2. 配置Swagger生成多份文档 #

在Program.cs中配置Swagger，为每个分组生成独立的API文档：

builder.Services.AddSwaggerGen(c =>
{
    // 为三个分组分别创建Swagger文档
    c.SwaggerDoc("Users", new OpenApiInfo { Title = "用户管理API", Version = "v1" });
    c.SwaggerDoc("Products", new OpenApiInfo { Title = "产品管理API", Version = "v1" });
    c.SwaggerDoc("Sales", new OpenApiInfo { Title = "客户购买API", Version = "v1" });

    // 可选：添加接口注释支持（需在项目属性中开启XML文档生成）
    var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
    var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
    c.IncludeXmlComments(xmlPath);
});

3. 配置Swagger UI显示多端点 #

继续在Program.cs中配置Swagger UI，添加三个独立的端点入口：

app.UseSwaggerUI(c =>
{
    // 绑定每个分组的Swagger文档
    c.SwaggerEndpoint("/swagger/Users/swagger.json", "用户管理API");
    c.SwaggerEndpoint("/swagger/Products/swagger.json", "产品管理API");
    c.SwaggerEndpoint("/swagger/Sales/swagger.json", "客户购买API");

    // 可选：设置Swagger UI直接通过根域名访问（无需加/swagger前缀）
    c.RoutePrefix = string.Empty;
});

4. 验证效果 #

启动项目后：

• 用户管理API的Swagger文档地址：example.com/swagger/Users/swagger.json，所有接口路由前缀为example.com/Users/
• 产品管理API的Swagger文档地址：example.com/swagger/Products/swagger.json，所有接口路由前缀为example.com/Products/
• 客户购买API的Swagger文档地址：example.com/swagger/Sales/swagger.json，所有接口路由前缀为example.com/Sales/
  每个Swagger页面都会包含Login控制器的接口，完全匹配你的需求。

这种方案既保留了单个项目共享数据库、后台逻辑的优势，又实现了不同客户端对应的独立API端点与文档，无需拆分项目。

内容的提问来源于stack exchange，提问作者Wim ten Brink