如何让调试器在修改后动态加载的.NET程序集上命中断点

调试器要命中源代码断点，必须满足两个条件：加载的程序集存在匹配的调试符号（PDB），且符号里记录了IL指令和本地源代码文件、行号的对应映射。你的流程里断点失效是因为：

• 用Lokad.ILPack序列化程序集、Mono.Cecil重写程序集的过程中，没有保留、生成匹配的调试符号
• 内存加载修改后的程序集时，没有同步传入对应符号，调试器无法建立IL和源码的映射关系

按以下步骤调整代码即可正常命中断点：

1. 读取程序集时同步加载原有调试符号 #

调用Mono.Cecil读取程序集时，开启符号读取开关，保留原程序集里的源码映射信息：

// 替换原来的ReadAssembly调用
var readParams = new ReaderParameters
{
    ReadSymbols = true
};
AssemblyDefinition assemblyDefinition = AssemblyDefinition.ReadAssembly(new MemoryStream(b), readParams);

如果ILPack生成的程序集字节没有内嵌符号，可以手动传入原程序集对应的PDB流给ReaderParameters.SymbolStream属性，原程序集的PDB路径可以通过Path.ChangeExtension(inAssembly.Location, ".pdb")获取。

2. 写入修改后程序集时同步生成PDB #

调用assemblyDefinition.Write时，传入写入参数同步生成可移植PDB（.NET Core/.NET 5+默认格式，.NET Framework可替换为原生PDB格式）：

// 替换原来的MemoryStream写入逻辑
MemoryStream asmStream = new MemoryStream();
MemoryStream pdbStream = new MemoryStream();
var writeParams = new WriterParameters
{
    SymbolWriterProvider = new PortablePdbWriterProvider(),
    SymbolStream = pdbStream,
    WriteSymbols = true
};
assemblyDefinition.Write(asmStream, writeParams);
byte[] resAsm = asmStream.ToArray();
byte[] resPdb = pdbStream.ToArray();

如果是.NET Framework环境，把PortablePdbWriterProvider替换为NativePdbWriterProvider即可生成Windows原生PDB。

3. 加载程序集时关联符号字节 #

用支持传入符号字节的Assembly.Load重载加载修改后的程序集，让运行时直接拿到匹配的PDB：

// 替换原来的Assembly.Load调用
Assembly resAssembly = Assembly.Load(resAsm, resPdb);

兜底方案（内存加载仍失效时使用） #

如果内存加载符号后还是无法命中，可以把修改后的程序集和PDB写入临时磁盘目录，再从磁盘加载，调试器会自动扫描同目录的匹配PDB：

string tempDir = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString("N"));
Directory.CreateDirectory(tempDir);
string asmPath = Path.Combine(tempDir, "IlGenTestTarget.Modified.dll");
string pdbPath = Path.ChangeExtension(asmPath, ".pdb");
File.WriteAllBytes(asmPath, resAsm);
File.WriteAllBytes(pdbPath, resPdb);
Assembly resAssembly = Assembly.LoadFrom(asmPath);

调试器设置调整 #

如果以上操作完成后断点还是不命中，检查Visual Studio调试配置：

• 打开「调试-选项-调试-常规」，取消勾选仅我的代码
• 暂时取消勾选要求源文件与原始版本完全匹配，避免因程序集哈希校验不通过拦截断点
• 确保目标程序集是Debug编译、未开启代码优化，发布版本的IL优化会打乱指令和行号的映射，导致断点偏移无法命中。

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