如何调试ASP.NET Core程序集，查看JWT Bearer认证的执行逻辑？

1. 对齐源码版本 #

确保你从GitHub下载的ASP.NET Core源码版本，和你Web API项目中引用的框架版本完全一致（比如项目用6.0.12，就下载对应tag的源码）。解压后找到src/Security/Authentication/JwtBearer目录，这是JWT Bearer认证的核心代码目录。

2. 修改项目依赖配置 #

打开你的Web API项目的.csproj文件，找到JWT相关的PackageReference节点，比如：

<PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="6.0.12" />

将其替换为本地源码项目的引用，路径根据你本地源码的存放位置调整：

<ProjectReference Include="..\aspnetcore\src\Security\Authentication\JwtBearer\Microsoft.AspNetCore.Authentication.JwtBearer.csproj" />

若编译时提示缺少其他依赖（比如Microsoft.AspNetCore.Authentication.Abstractions），同理将对应PackageReference替换为本地源码中对应项目的ProjectReference。

3. 配置Visual Studio调试选项 #

• 进入工具 > 选项 > 调试 > 常规：
  • 取消勾选「启用仅我的代码」，确保调试器能进入框架源码。
  • 勾选「启用源链接支持」（可选，若本地源码符号完整可跳过）。
• 进入调试 > 符号：
  • 勾选「Microsoft符号服务器」，或添加本地源码生成的符号文件路径，保证调试时能匹配源码。

4. 设置断点跟踪验证流程 #

• 打开本地源码中的JwtBearerHandler.cs，找到HandleAuthenticateAsync方法（Token验证的入口），在关键逻辑处设置断点：
  • ValidateTokenAsync：负责Token的核心验证逻辑
  • ValidatePayload：处理Claims有效性校验
  • ValidateSignature：验证Token签名的合法性
• 启动你的Web API项目，发送携带JWT的请求，调试器会自动进入框架源码断点，逐行跟踪验证的完整流程。

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