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

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

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

2025-12-03

浏览次数：次

返回列表

在C#中创建自定义异常类需继承Exception、命名以“Exception”结尾，并实现四个标准构造函数；应在语义化错误区分、业务逻辑特异性及通用异常不适用时使用；需避免吞异常、提供上下文属性、支持序列化以保障兼容性。

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

在 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. 遵循良好的异常处理实践

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

Tunee AI

新一代AI音乐智能体

1104 查看详情 Tunee AI

避免吞掉异常（空 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;
}