目录
- 一. 使用Serilog结构化日志记录日志信息
- 二. 捕获全局异常
- 三. 使用AOP统一处理异常
一. 使用Serilog结构化日志记录日志信息
Serilog包的引用和使用语法都可以在网上找到（https://github.com/serilog/serilog/wiki/），不再赘述，这里仅分享一下自己在项目中的简单使用。
FileLogHelper帮助类对日志记录进行封装：
public static class FileLogHelper
{/// <summary>/// 日志模板/// </summary>private static string ErrorTemplate = "{Timestamp:yyyy-MM-dd HH:mm:ss} {Message:j} {NewLine} {Exception} {NewLine}";private static string InfoTemplate = "{Message:j} {NewLine}";/// <summary>/// 记录异常信息/// </summary>private static ILogger ErrorLog;/// <summary>/// 记录各类日志信息/// </summary>private static ILogger InfoLog;static FileLogHelper(){InitLog();}private static void InitLog(){ErrorLog = new LoggerConfiguration().MinimumLevel.Warning() // 最小日志级别，小于该级别的日志不会记录.WriteTo.Map(le => "",(d, lc) =>{lc.File($"Log/Error/{d:yyyyMMdd}.txt", // 日志文件路径，文件以日期命名rollingInterval: RollingInterval.Day, // 日志文件按天滚动创建，即每天创建新的文件outputTemplate: ErrorTemplate, // 指定日志输出模板rollOnFileSizeLimit: true, // 滚动文件是否限制大小 fileSizeLimitBytes: 52428800 // 滚动文件限制的大小，单位byte， 52428800为50M);}).CreateLogger();InfoLog = new LoggerConfiguration().MinimumLevel.Information().WriteTo.Map(le => "",(d, lc) =>{lc.File($"Log/Info/{d:yyyyMMdd}.txt",rollingInterval: RollingInterval.Day,outputTemplate: InfoTemplate,rollOnFileSizeLimit: true,fileSizeLimitBytes: 52428800);}).CreateLogger();}/// <summary>/// 记录异常信息/// </summary>/// <param name="exception"></param>/// <param name="message"></param>public static void LogError(Exception exception, string message = "错误"){ErrorLog.Error(exception, message);}/// <summary>/// 记录各类日志信息（结构化记录）/// </summary>/// <param name="title"></param>/// <param name="message"></param>/// <param name="detailMessage"></param>/// <param name="paramter"></param>public static void LogInfo(string title, string message, string detailMessage, object paramter){LogInfoView log = new LogInfoView(title, message, detailMessage, paramter);InfoLog.Information("{@log}", log);}/// <summary>/// 结构化日志对象/// </summary>private class LogInfoView{public LogInfoView(string title, string message, string detailMessage, object paramter){ this.Title = title;this.Message = message;this.DetailMessage = detailMessage;this.Paramter = paramter;}public string DateTime { get; set; } = System.DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");public string Title { get; set; }public string Message { get; set; }public string DetailMessage { get; set; }public object Paramter { get; set; }}
}帮助类中创建了两个静态日志对象ErrorLog和InfoLog，方法LogError通过ErrorLog对象记录异常信息，方法LogInfo通过InfoLog对象记录一般日志信息：
- ErrorLog和InfoLog分别指定了不同的日志文件目录(Log/Error/与Log/Info/)，便于区分和查找；
- InfoLog使用结构化日志，将日志信息包装成LogInfoView对象，在文本中以JSON格式记录。InfoLog使用了与ErrorLog不同的日志模板，仅保留了{Message:j}，这样一条记录就是一个JSON数据，整个日志文件中的数据就是JSON Lines格式，方便内容解析。
按上述设置后，产生的日志文件目录如下：
结构化日志InfoLog产生的日志内容如下，每一行都是json格式：
（用户密码是不应该输出到日志的，这里只是为了演示效果）：
非结构化的ErrorLog产生的日志内容如下：
二. 捕获全局异常
winform客户端中，如果程序发生异常后没有对其捕获处理，就会造成系统崩溃，影响用户体验。一种保险的方式是添加全局异常捕获事件，所有未处理的异常都会在这里被捕获到，从而避免系统直接闪崩。异常信息的记录使用了上面第一节中的FileLogHelper帮助类。
internal static class Program
{/// <summary>/// 应用程序的主入口点。/// </summary>[STAThread]static void Main(){Application.EnableVisualStyles();Application.SetCompatibleTextRenderingDefault(false);CatchApplicationException(); // 捕获全局异常Application.Run(new MainForm());}/// <summary>/// 捕获全局异常/// </summary>private static void CatchApplicationException(){//捕获UI异常Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);Application.ThreadException += OnUIThreadExceptionCatched;//捕获非UI异常AppDomain.CurrentDomain.UnhandledException += OnDomainExceptionCatched;}/// <summary>/// 捕获UI异常/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void OnUIThreadExceptionCatched(object sender, ThreadExceptionEventArgs e){FileLogHelper.LogError(e.Exception, "未处理的UI异常");MessageBox.Show("软件发生UI错误！", "提示", MessageBoxButtons.OK, MessageBoxIcon.Error, MessageBoxDefaultButton.Button1, MessageBoxOptions.DefaultDesktopOnly);}/// <summary>/// 捕获非UI异常/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void OnDomainExceptionCatched(object sender, UnhandledExceptionEventArgs e){FileLogHelper.LogError((Exception)e.ExceptionObject, "未处理的异常");MessageBox.Show("软件发生错误！", "提示", MessageBoxButtons.OK, MessageBoxIcon.Error, MessageBoxDefaultButton.Button1, MessageBoxOptions.DefaultDesktopOnly);}
}
三. 使用AOP统一处理异常
使用AOP处理异常的好处就是不用写大量的try-catch，一是减少重复的代码，二是不让try-catch影响核心代码的可读性；缺点就是统一处理异常后，灵活性会降低。要不要使用可以根据自己的具体情况来。
在异常处理方面，使用起来比较方面的AOP组件，这里推荐两个：一个是Postsharp（https://doc.postsharp.net/），另一个是Rougamo（肉夹馍，https://github.com/inversionhourglass/Rougamo）。推荐的原因是，这两个都可以通过特性Attribute标注的方式进行代码织入，都支持应用于方法、类、程序集等不同的粒度，且都支持设置可访问性属性。一些区别在于：Rougamo是完全开源的，可以随意使用；而Postsharp分商业版和社区版，引用ChatGPT上的解释，比较明了：
社区版虽说功能有限制，但也足够我们使用了。
这里便以PostSharp举例。如何引用Postsharp可以参考官方文档：https://doc.postsharp.net/deploymentconfiguration/deployment，在NuGet中直接搜索安装就可以。
我们创建一个自己的异常处理Attribute，如下：
(参考文档：https://doc.postsharp.net/custompatterns/aspects/tutorials/exception-handling)
/// <summary>
/// 异常处理
/// </summary>
[PSerializable]
public class LogAttribute : OnExceptionAspect
{/// <summary>/// 异常处理结束后的方法返回值/// </summary>public object ReturnValue { get; set; }/// <summary>/// 异常处理方式/// FlowBehavior.Return:忽略异常。如果方法有返回值，必须通过设置ReturnValue来设置方法的返回值。/// FlowBehavior.Continue:忽略异常，在OnException方法中，与FlowBehavior.Return的作用一样。/// 同样的，如果方法有返回值，必须通过设置ReturnValue来设置方法的返回值。/// FlowBehavior.RethrowException:在异常处理程序退出后重新引发原始异常。/// FlowBehavior.ThrowException:一旦异常处理程序退出，就会抛出一个新的异常。/// 当应该向用户隐藏原始异常的详细信息时，或者当要显示更有意义的异常时，这很有用。/// 抛出新异常时，必须将新异常对象分配给MethodExecutionArgs的exception成员。/// </summary>public FlowBehavior FlowBehavior { get; set; } = FlowBehavior.Return;/// <summary>/// 不记录日志/// </summary>public bool IgnoreLogRecord { get; set; } = false;/// <summary>/// 捕获异常/// </summary>/// <param name="args"></param>public override void OnException(MethodExecutionArgs args){if (!IgnoreLogRecord){// 记录异常日志FileLogHelper.LogError(args.Exception);}args.FlowBehavior = FlowBehavior; // 设置异常处理方式args.ReturnValue = ReturnValue; // 设置方法返回值}
}
自定义的LogAttribute 类中，新加了三个属性：ReturnValue、FlowBehavior、IgnoreLogRecord
- ReturnValue属性：对于有返回值的方法发生异常时，通过ReturnValue属性，我们可以自定义异常处理结束后的方法返回值；
- FlowBehavior属性：可以用来设置异常处理方式，上面的代码中我们默认设置为FlowBehavior.Return，即在异常处理程序OnException处理完后忽略异常。
- IgnoreLogRecord属性：可以用来设置是否记录异常信息，配合上面第一节说的日志记录来使用，默认记录日志。
接下来我们举几个例子来演示如何使用它。
- 在有返回值的方法中，如果想忽略异常并指定异常发生后的返回值，可以这样使用：
private void OnLoginFormLoad(object sender, EventArgs e)
{m_allRoles = GetLoginRoles();
}/// <summary>
/// 获取角色集合
/// 发生异常后返回null
/// </summary>
/// <returns></returns>
[Log(ReturnValue = null)]
private List<LoginRole> GetLoginRoles()
{using (UDPDbContext dbContext = new UDPDbContext()){dbContext.Dispose(); // 这里故意释放掉数据库上下文，为的是让下面的代码抛出异常return dbContext.LoginRoles.ToList();}
}
窗体Load方法中调用GetLoginRoles()方法获取角色集合，GetLoginRoles()方法上我们用LogAttribute进行标记(特性标记可以省去特性类名后面的“Attribute”)，并指定ReturnValue = null，即方法发生异常后，返回null。
我们打断点进行观察，异常发生后，进入异常处理程序OnException，在异常处理程序中记录日志（默认记录），设置异常处理方式（默认FlowBehavior.Return忽略异常），最后设置返回值ReturnValue，这个ReturnValue的值就是我们在方法上标记LogAttribute时指定的。
异常处理程序执行完后，程序继续执行，在OnLoginFormLoad方法中，发现GetLoginRoles()并没有抛出异常，并且返回了null，达到了预期效果。
- 如果担心基础层的日志帮助类FileLogHelper出现异常，这种情况下，一般要吞噬掉异常，不能让日志记录的异常影响到我们的业务逻辑，并且我们不应该再去让异常处理程序OnException去记录日志了，因为此时记录日志的代码已经不能正常工作了。
使用LogAttribute特性，我们可以这样处理：
[Log(AttributeTargetMemberAttributes = MulticastAttributes.Public, IgnoreLogRecord = true)]
public static class FileLogHelper
{/** 此处省略日志记录代码，与第一节中的代码保持一模一样*/
}
LogAttribute特性直接应用于FileLogHelper类上，并通过给AttributeTargetMemberAttributes 属性赋值MulticastAttributes.Public，使其仅对类中的public方法起作用；IgnoreLogRecord 赋值为true，则在异常处理程序OnException中不记录异常。
- 还可能遇到一种情况：对整个类的异常统一设置异常处理方式后，对其中的个别方法需要特殊处理。比如类中的大部分方法都不需要记录日志，但是对于其中的某个方法需要记录异常日志。
举个代码示例，下面的MainForm窗体类中，除了登录方法OnLoginOutButtonClick外，其他的都不需要记录异常日志，那我们可以这样进行特性标注：
[Log(AspectPriority = 1, IgnoreLogRecord = true)]
public partial class MainForm : Form
{public MainForm(){InitializeComponent();}private void InitializeComponent(){// ...}private void OnMainFormLoad(object sender, EventArgs e){// ...}[Log(AspectPriority = 2, IgnoreLogRecord = false)]private void OnLoginOutButtonClick(object sender, EventArgs e){// ...}
}
由于使用了多层异常处理特性，我们需要使用AspectPriority属性来指定优先级。当符合多个异常处理配置的条件时，按优先级高的来处理（AspectPriority值大的）。参考文档：https://doc.postsharp.net/custompatterns/aspects/applying/attribute-multicasting
- 异常处理还可以应用于整个程序集，如下，在程序集文件AssemblyInfo.cs中进行配置，AssemblyInfo.cs文件在项目的Properties路径下：
以上就是常见的使用场景。
这里再做一点扩展了解：
Postsharp和Rougamo都是通过静态织入的方式实现了AOP，即在编译时将额外的异常处理代码织入到我们的源代码中。
我们拿上面的日志帮助类FileLogHelper为例，使用[Log(AttributeTargetMemberAttributes = MulticastAttributes.Public, IgnoreLogRecord = true)]进行标记后，进行编译，然后将编译后的dll使用反编译工具查看源码：
可以看出，FileLogHelper类中的Public方法在编译后自动加上了try-catch块。
