使用[UnmanagedCallersOnly]导出函数的.NET 8 DLL调试失败排查

问题核心原因 #

你遇到的断点无法命中，本质是AOT编译后的DLL是原生机器码文件，而非普通托管DLL。默认的.NET Framework托管调试器没法直接关联AOT生成的原生代码与原托管代码的断点，必须调整调试配置和编译参数来实现符号映射。

解决步骤 #

• 启用混合模式调试
  打开.NET Framework宿主项目的属性，切换到「调试」标签页，勾选「启用本机代码调试」。让调试器同时处理托管和原生代码，才能识别AOT DLL里的调试符号。

• 调整AOT编译参数，生成完整调试符号
  修改发布命令，添加-p:DebugType=full参数，确保生成包含原生调试信息的.pdb文件：

  dotnet publish -f net8.0 -c Debug -r win-x64 -p:PublishAot=true -p:NativeLib=Shared -p:SelfContained=true -p:DebugType=full
  

  重新编译后，把新生成的.dll和.pdb复制到宿主程序目录，务必保证两者是同一编译输出的匹配文件。

• 手动加载符号（按需操作）
  调试时打开VS的「模块」窗口（路径：调试 → Windows → 模块），找到ClassLibrary.dll，如果符号状态显示「未加载符号」，右键点击选择「加载符号」，指定你复制过来的.pdb文件路径。

额外说明 #

AOT编译会把托管IL直接转成原生机器码，原托管代码的断点需要通过原生调试符号来映射，所以必须同时启用原生调试支持，且编译时要生成完整的调试信息，否则调试器找不到断点对应的机器码位置。

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