.NET Minimal API安全端点返回404问题及AddControllers疑问

一、使用IdentityUser时/secure端点返回404的解决办法 #

这个问题大概率出在路由配置或Identity中间件顺序错误上，按以下步骤排查：

• 检查路由定义
  确认/secure端点的路由注解（比如[Route("secure")]或[HttpGet("secure")]）拼写正确，没有和Identity内置路由冲突。如果是最小API，要保证端点注册时的路径没写错。

• 核对中间件顺序
  .NET中间件顺序不能乱，必须按这个顺序配置：

  1. 先注册builder.Services.AddAuthentication(...)和builder.Services.AddIdentity<IdentityUser, IdentityRole>(...)
  2. 管道中先调用app.UseAuthentication()，再调用app.UseAuthorization()，最后才注册端点（比如app.MapControllers()或者最小API的app.MapGet("/secure", ...)）
     顺序错了会导致身份验证逻辑不生效，甚至路由匹配失败返回404。

• 检查Identity配置细节

  • 确认已经正确配置Identity的存储（比如用AddDbContext关联IdentityDbContext）
  • 如果是最小API结合Identity，要确保加了builder.Services.AddEndpointsApiExplorer()，并且端点的授权策略正确（比如加[Authorize]属性或者调用RequireAuthorization()方法）

• 对比/login端点的差异
  把注释的/login和用Identity的登录逻辑对比，重点看：

  • 是否正确生成并返回了有效的JWT令牌（如果用JWT验证）
  • 登录后是否成功设置了用户身份（比如SignInManager.PasswordSignInAsync是否返回成功状态）

二、是否需要用builder.Services.AddControllers()？ #

分两种场景：

• 如果你的API是基于控制器开发（继承ControllerBase或ApiController），必须调用builder.Services.AddControllers()，它会注册控制器需要的所有服务（模型绑定、路由、过滤器等），之后还要在管道里调用app.MapControllers()启用控制器路由。
• 如果是用最小API（直接用app.MapGet/Post等定义端点），不需要调用AddControllers()，用builder.Services.AddEndpointsApiExplorer()配合AddSwaggerGen()就能满足API文档和基础功能需求。

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