调试.NET 6 C#项目时PDB文件加载失败问题求助

框架PDB加载失败修复方案 #

• 配置符号服务器并清理缓存
  在Rider中进入Settings > Build, Execution, Deployment > Debugger > Symbols，勾选Microsoft Symbol Servers，点击Clear Caches清理本地符号缓存后重启调试。
  命令行调试前先设置环境变量：

  export DOTNET_SYMBOL_SERVER=https://msdl.microsoft.com/download/symbols
  

  再执行dotnet run --debug。

• 手动下载框架符号文件
  先安装dotnet-symbol工具：

  dotnet tool install -g dotnet-symbol
  

  针对目标运行时目录下载符号（以.NET 6 ASP.NET Core运行时为例）：

  dotnet symbol /usr/share/dotnet/shared/Microsoft.AspNetCore.App/6.0.21/*.dll
  

  该命令会自动将匹配的PDB文件下载到对应DLL所在目录。

ASP.NET 6调试会话终止修复方案 #

• 启用诊断环境变量
  终端中设置环境变量后再启动调试：

  export COMPlus_EnableDiagnostics=1
  dotnet run --debug
  

• 排查端口拦截问题
  确保调试器端口未被防火墙或安全软件拦截，可指定固定调试端口：

  export DOTNET_DEBUG_PORT=5005
  dotnet run --debug
  

  同时确认该端口未被其他进程占用。

验证并修复.NET安装完整性 #

• 执行dotnet --info确认SDK与运行时版本匹配，安装路径无异常。
• 若使用.NET 6.0.400+版本，运行以下命令验证并修复损坏文件：

  dotnet validate --repair
  

优化调试器符号加载策略 #

• Rider中，在Settings > Build, Execution, Deployment > Debugger > Symbols的Excluded modules中添加*.dll，仅加载项目自身符号。
• VS Code中，修改.vscode/launch.json配置：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": ".NET Core Launch (console)",
              "type": "coreclr",
              "request": "launch",
              "program": "${workspaceFolder}/bin/Debug/net6.0/YourProject.dll",
              "justMyCode": true,
              "symbolOptions": {
                  "excludeSymbols": ["Microsoft.*", "System.*"]
              }
          }
      ]
  }
  

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