Swagger UI未显示ASP.NET Core Identity端点的问题排查

开发者阿泽

2026-6-22

ASP.NET Core Identity 自带API未在Swagger显示的缺失配置

要让Identity自带的API端点出现在Swagger UI中，你需要补充以下关键配置：

启用Identity API端点路由
在Program.cs的路由映射阶段，必须显式添加Identity API的路由配置，否则这些端点不会被注册。示例代码：

app.MapControllers();
// 替换为你的自定义用户类（如ApplicationUser），如果使用默认IdentityUser则直接用该类型
app.MapIdentityApi<ApplicationUser>();

使用API专用的Identity服务注册方式
传统的AddIdentity<TUser, TRole>不会自动启用API端点支持，需要改用专为API设计的AddIdentityApiEndpoints<TUser>方法注册服务。示例：
```
builder.Services.AddIdentityApiEndpoints<ApplicationUser>()
    .AddEntityFrameworkStores<ApplicationDbContext>();
```
确保Swagger未过滤Identity端点
检查Swagger生成器配置，避免通过DocumentFilter或OperationFilter意外排除Identity的API端点。如果存在类似过滤逻辑，需调整规则保留Identity相关端点。