C# 如何创建自定义异常类 - 良好的异常处理实践

来源：这里教程网时间：2026-02-21 17:32:31 作者：

在 C# 中创建自定义异常类是构建健壮、可维护应用程序的重要部分。良好的异常处理不仅能帮助开发者快速定位问题，还能提升代码的可读性和可维护性。直接继承 Exception 类并遵循命名和设计规范，是实现自定义异常的关键。

1. 创建自定义异常类的基本步骤

自定义异常类应以 "Exception" 结尾，这是 .NET 的命名约定，有助于其他开发者识别这是一个异常类型。

public class InvalidUserStateException : Exception
{
    public InvalidUserStateException()
    {
    }
<pre class='brush:php;toolbar:false;'>public InvalidUserStateException(string message) : base(message)
{
}
public InvalidUserStateException(string message, Exception innerException) : base(message, innerException)
{
}
protected InvalidUserStateException(System.Runtime.Serialization.SerializationInfo info,
    System.Runtime.Serialization.StreamingContext context) : base(info, context)
{
}

}

上面的构造函数覆盖了常见使用场景：无参数、带消息、包含内部异常，以及支持序列化（用于远程调用或持久化）。最后一个构造函数虽然不常手动调用，但在分布式系统中必不可少。

2. 何时使用自定义异常

不要为每种错误都创建新异常。应在以下情况考虑自定义：

需要区分特定业务逻辑错误，比如用户状态非法、订单已锁定等 希望上层代码能通过 catch 明确捕获这类语义化异常 框架或通用异常（如 ArgumentException）无法准确表达错误含义

例如，抛出 InvalidUserStateException 比抛出普通 Exception("用户状态无效") 更清晰，也更容易被测试和处理。

3. 遵循良好的异常处理实践

自定义异常只是起点，合理使用才真正体现价值。

避免吞掉异常（空 catch），至少记录日志 在适当层级包装并抛出，例如将数据库异常转为更高级别的业务异常 提供有意义的错误消息，必要时附带上下文数据（可通过属性扩展）

public class OrderProcessingException : Exception
{
    public string OrderId { get; }
<pre class='brush:php;toolbar:false;'>public OrderProcessingException(string orderId, string message, Exception inner) 
    : base($"订单 {orderId}: {message}", inner)
{
    OrderId = orderId;
}

}

这样上层可以访问 OrderId 属性，便于追踪和展示。