ilruntime-debug

name	ilruntime-debug
description	Debug ILRuntime ILIntepreter execution errors. Invoke whenever ILIntepreter internal errors occur and root cause is unclear - always check stack state first before diving into interpreter internals.

ILRuntime ILIntepreter 调试指南

适用场景

当遇到任何 ILIntepreter 内部错误且无法立即判断原因时，优先使用此技能：

必用场景

• StackOverflowException（解释器栈损坏，非 C# 原生栈溢出）
• ArgumentOutOfRangeException 访问 mStack 时越界
• 任何 ILRuntime.Runtime.Intepreter.ILIntepreter 栈跟踪中的异常

常用场景

• AOP 注入代码执行后返回值读取失败
• 泛型类型/方法注入后行为异常
• 方法调用参数传递错误
• 值类型参数/返回值处理异常
• 栈不平衡导致的各种诡异行为

使用原则

1. 优先看栈：遇到 ILIntepreter 相关错误，第一反应是添加 DumpStack 日志查看栈状态
2. 后看源码：只有在栈信息无法解释问题时，才深入分析 ILIntepreter 和 RuntimeStack 等内部代码
3. 防御性检查：在关键位置添加边界检查，帮助快速定位问题

---

调试流程

步骤1：添加栈状态日志

在 ILRuntime/Runtime/Intepreter/ILIntepreter.cs 第 282 行（code = ip->Code; 之后）添加：

System.Console.WriteLine(AppDomain.DebugService.DumpStack(esp, stack).ToString());

注意：这会在每个 IL 指令执行前打印完整栈状态，日志量极大。建议：

1. 通过测试框架只运行单个测试用例
2. 观察崩溃前的最后几帧栈状态

步骤2：分析 DumpStack 输出

输出格式示例：

(0x1F4839A0C50) Type:Object Value:0 ValueLow:0 Text:HotfixAOT.GenericStruct`1[System.Int32]
(0x1F4839A0C5C) Type:Integer Value:42 ValueLow:0 Text:42
->(0x1F4839A0C68) Type:Null Value:-1 ValueLow:0 Text:null |Base Method:...
Managed Objects:
(0)HotfixAOT.GenericStruct`1[System.Int32]

关注要点：