.NET 7 API单认证方案下AuthenticationHandler无法获取ActionContext

问题场景 #

• 在ASP.NET Core API项目中，在AuthenticationHandler内通过IActionContextAccessor获取ActionContext时出现异常：
  • 仅注册1个AuthenticationScheme时，返回的ActionContext为null
  • 添加第二个AuthenticationScheme后，ActionContext可正常获取
• 调试对比发现两种场景的调用堆栈存在明显差异：正常场景的调用栈包含负责填充IActionContextAccessor的ResourceInvoker，单方案场景则无

核心原因 #

这是ASP.NET Core认证中间件的执行时机优化逻辑导致的：

1. 单认证方案场景：当系统只配置了一个默认认证方案时，框架会在路由匹配流程启动前提前执行认证逻辑。此时ResourceInvoker还未初始化，也就不会填充IActionContextAccessor中的ActionContext，所以获取到的结果为null。
2. 多认证方案场景：当存在多个认证方案时，框架无法提前确定当前请求要使用的具体方案，必须等待路由匹配完成（此时ResourceInvoker已完成初始化并填充了ActionContext），再根据请求端点的配置（比如[Authorize]特性指定的方案）选择对应认证逻辑执行，因此IActionContextAccessor能获取到有效的ActionContext。

本质上是单方案时认证逻辑执行过早，未进入路由处理环节；多方案时认证逻辑延迟到路由匹配后执行，此时ActionContext已就绪。

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