ASP.NET WebForms全局异常处理：现有项目日志改造需求

下面是一套实用的实现方案，既能保留你现有给用户展示异常的逻辑，又能把所有异常信息持久化到日志文件里：

1. 封装通用日志工具类 #

为了避免在每个catch块里重复写日志代码，先搞个工具类统一处理日志写入逻辑：

public static class ExceptionLogger
{
    public static void WriteLog(Exception ex, string eventName = "")
    {
        // 指定日志存储目录，放在项目根目录的Logs文件夹下
        string logDir = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Logs");
        
        // 如果目录不存在就自动创建
        if (!Directory.Exists(logDir))
        {
            Directory.CreateDirectory(logDir);
        }
        
        // 按日期生成日志文件名，避免单文件过大
        string logFileName = $"{DateTime.Now:yyyy-MM-dd}.log";
        string fullLogPath = Path.Combine(logDir, logFileName);

        // 构造详细的日志内容，包含时间、触发事件、异常信息和堆栈
        string logContent = $"[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] " +
                           $"触发事件: {eventName}\n" +
                           $"异常信息: {ex.Message}\n" +
                           $"堆栈跟踪: {ex.StackTrace}\n\n";

        // 追加写入日志，用using确保流自动释放
        using (StreamWriter writer = File.AppendText(fullLogPath))
        {
            writer.Write(logContent);
        }
    }
}

2. 修改现有事件的catch块 #

现在只需要在每个事件的catch里调用这个工具类，同时保留原有的用户提示逻辑：

protected void Page_Load(object sender, EventArgs e) 
{ 
    try 
    { 
        checkLogin(); //some logic 
    } 
    catch (Exception ex) 
    { 
        // 写入日志，传入异常和当前事件名称，方便快速定位问题
        ExceptionLogger.WriteLog(ex, "Page_Load");
        // 保留原有的用户提示
        ShowMessage(ex.Message + "<br />" + ex.StackTrace, 1); 
    } 
}

// 其他事件照猫画虎就行
protected void Button_Click(object sender, EventArgs e)
{
    try
    {
        // 你的业务逻辑代码
    }
    catch (Exception ex)
    {
        ExceptionLogger.WriteLog(ex, "Button_Click");
        ShowMessage(ex.Message + "<br />" + ex.StackTrace, 1);
    }
}

3. 几个要注意的细节 #

• 权限问题：要确保应用程序池的身份对Logs文件夹有写入权限，不然会抛出权限异常。
• 日志清理：如果项目访问量高，日志文件会越来越大，可以加个定时清理逻辑（比如只保留最近7天的日志）。
• 敏感信息脱敏：如果异常里包含用户密码、手机号这类敏感数据，记得在写入日志前做脱敏处理，别把隐私信息泄露了。
• 异步优化：如果担心日志写入拖慢请求响应，可以把写入操作改成异步的，比如用await writer.WriteAsync(logContent)，记得把工具类的方法也改成异步。

这样改造后，既能让用户看到异常提示，又能把所有异常细节存到日志里，后期排查问题会方便很多。

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