在C#中如何在异常发生时转储当前作用域的所有局部变量？

方法1：手动收集（简单直接） #

这是最直观的方案，适合小规模场景，直接在catch块里显式输出所有局部变量的值：

void Demo() 
{
    int a = 20;
    int b = 20;
    string c = "Hello";
    int d = 0; // 提前初始化，避免异常时变量未赋值无法访问
    try
    {
        d = 1 / (a-b);
    }
    catch (Exception ex)
    {
        // 替换为你的日志框架调用，比如logger.LogError
        Console.WriteLine($"异常信息：{ex.Message}");
        Console.WriteLine($"局部变量值：a={a}, b={b}, c={c}, d={d}");
    }
}

注意：未完成赋值的变量（比如示例中异常发生时的d）必须提前初始化，否则catch块无法访问。

方法2：调试API自动收集（自动化方案） #

如果需要自动捕获局部变量，可借助.NET调试API遍历调用栈帧获取变量信息，适合调试阶段使用：

using System.Diagnostics;
using System.Reflection;

public static class VariableDumper
{
    public static void DumpLocalVariables()
    {
        // 获取发生异常的方法调用栈帧
        var stackTrace = new StackTrace();
        var targetFrame = stackTrace.GetFrame(1);
        var method = targetFrame?.GetMethod();
        if (method == null) return;

        // 获取方法的局部变量元数据（需依赖.pdb调试符号）
        var localVars = method.GetMethodBody()?.LocalVariables;
        if (localVars == null) return;

        Console.WriteLine($"[{method.Name}] 局部变量列表：");
        foreach (var varInfo in localVars)
        {
            // 跳过编译器生成的临时变量
            if (varInfo.IsPinned || varInfo.LocalType.IsByRef) continue;
            
            // 读取变量值（仅在调试模式/带pdb的环境下有效）
            // 若需生产环境可靠读取，可使用ClrMD等进程内存分析库
            object? varValue = targetFrame.GetMethod().Invoke(null, null);
            Console.WriteLine($"{varInfo.LocalType.Name} {varInfo.Name} = {varValue}");
        }
    }
}

在catch块中调用即可：

void Demo() 
{
    try
    {
        int a = 20;
        int b = 20;
        string c = "Hello";
        int d = 1 / (a-b);
    }
    catch (Exception ex)
    {
        VariableDumper.DumpLocalVariables();
    }
}

此方案必须保留程序的.pdb调试符号文件，生产环境若剥离pdb则无法正常工作。

方法3：AOP框架批量处理（大型项目适用） #

使用PostSharp、AspectCore等AOP框架，通过切面实现全局异常时的变量自动转储，无需逐个修改try-catch块。以PostSharp为例：

1. 安装PostSharp NuGet包
2. 定义异常处理切面：

using PostSharp.Aspects;

[Serializable]
public class DumpVarsOnExceptionAttribute : OnExceptionAspect
{
    public override void OnException(MethodExecutionArgs args)
    {
        // 输出方法参数
        Console.WriteLine($"[{args.Method.Name}] 方法参数：");
        foreach (var arg in args.Arguments)
        {
            Console.WriteLine(arg);
        }

        // 输出局部变量（依赖pdb符号）
        var localVars = args.Method.GetMethodBody()?.LocalVariables;
        if (localVars != null)
        {
            Console.WriteLine("局部变量：");
            foreach (var varInfo in localVars)
            {
                object? varValue = args.GetLocalVariableValue(varInfo);
                Console.WriteLine($"{varInfo.LocalType.Name} {varInfo.Name} = {varValue}");
            }
        }

        base.OnException(args);
    }
}

3. 在目标方法上标记切面：

[DumpVarsOnException]
void Demo() 
{
    int a = 20;
    int b = 20;
    string c = "Hello";
    int d = 1 / (a-b);
}

该方案可批量覆盖多个方法，适合大型项目统一异常处理需求。

关键注意点 #

• 未赋值变量：异常发生时未完成赋值的变量必须提前初始化，否则无法在catch块访问。
• 调试符号依赖：所有自动收集变量的方案都需要.pdb文件，生产环境使用需权衡符号文件的部署成本。
• 性能开销：自动收集变量（尤其是调试API或AOP方案）会产生一定性能损耗，生产环境需谨慎启用。

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