C#如何为异常追加自定义详情且保留原始抛出位置信息

异常处理目标：

• 工作函数抛出的异常仅向上层传递单个包含全量必要信息的异常实例，由上层统一决策日志记录、用户告警等处理逻辑
• 异常向上传递过程中，必须保留最初抛出位置的函数名、行号等完整堆栈信息
• 异常需要携带当前函数的业务上下文信息（如入参、执行状态等排查所需内容）

现有示例代码如下：

上层调用入口 #

try
{
    string arg = "[Important-Details]";
    Worker(arg);
}
catch (Exception ex)
{
    Console.WriteLine(ex.ToString()); // 上层统一处理日志、弹窗等逻辑
}

工作函数初始实现 #

public static void Worker(string details)
{
    try
    {
        int i = 1;
        int j = 0;
        int k = i / j; // 第90行，异常实际触发位置
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Failed function with details:{details} - {ex.ToString()}"); // 此处输出可正确显示第90行异常信息，但无法获取Worker的调用来源
        throw; // 此处重抛后，上层捕获的异常堆栈会将行号标记为当前throw语句所在行，且丢失自定义拼接的上下文信息
    }
}

现存问题 #

初始实现无法满足目标：

• 直接使用throw重抛原始异常时，自定义拼接的业务上下文信息不会随异常传递到上层
• 重抛后异常堆栈的行号会被重置为throw语句位置，上层无法直接定位到最初触发异常的第90行代码
• 若同时在Worker内部和上层分别输出日志，会产生冗余日志，违背上层统一处理的设计要求

使用.NET提供的ExceptionDispatchInfo类即可实现需求，该类可以完整捕获异常的原始堆栈信息，重抛时不会覆盖原始异常的抛出位置，同时支持将自定义上下文附加到异常实例上随异常传递。

方案1：无自定义异常依赖的通用实现 #

适合不需要区分自定义异常类型的场景，直接在原始异常上附加上下文后重抛：

using System.Runtime.ExceptionServices;

public static void Worker(string details)
{
    try
    {
        int i = 1;
        int j = 0;
        int k = i / j; // 第90行
    }
    catch (Exception ex)
    {
        // 将自定义业务上下文存入异常自带的Data字典，上层可直接读取
        ex.Data["ExecuteContext"] = $"Failed function with details:{details}";
        // 捕获异常的完整原始堆栈信息
        var exceptionInfo = ExceptionDispatchInfo.Capture(ex);
        // 抛出时会完整保留第90行的原始抛出位置信息，不会被当前行覆盖
        exceptionInfo.Throw();
    }
}

上层捕获异常后：

• 调用ex.ToString()输出的堆栈会准确显示异常最初在第90行触发，包含完整的函数调用链
• 可通过ex.Data["ExecuteContext"]读取附加的业务上下文信息
• 全程仅传递一个异常实例，无需拼接多位置日志，上层可直接完成统一处理

方案2：自定义异常包装实现 #

适合需要明确区分业务异常类型的场景，将原始异常作为内部异常包装后重抛：

using System.Runtime.ExceptionServices;

// 自定义业务异常类型
public class BusinessExecuteException : Exception
{
    public BusinessExecuteException(string message, Exception innerException) 
        : base(message, innerException) { }
}

public static void Worker(string details)
{
    try
    {
        int i = 1;
        int j = 0;
        int k = i / j; // 第90行
    }
    catch (Exception ex)
    {
        var wrappedEx = new BusinessExecuteException(
            $"Failed function with details:{details}", 
            ex
        );
        var exceptionInfo = ExceptionDispatchInfo.Capture(wrappedEx);
        exceptionInfo.Throw();
    }
}

上层捕获BusinessExecuteException后：

• 可直接通过ex.Message获取自定义上下文信息
• 通过ex.InnerException可获取原始除零异常的完整堆栈，准确定位第90行的触发位置
• 可基于异常类型做差异化的处理逻辑

避坑说明 #

• 禁止在catch块中使用throw ex;写法，该写法会直接截断原始堆栈，将异常抛出位置强制标记为当前语句所在行
• 不要在工作函数内部编写日志打印、用户弹窗等处理逻辑，所有异常处理逻辑统一收敛到上层入口，避免重复执行
• 附加到Data字典的上下文建议使用固定常量作为key，上层读取时做好非空校验即可。

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