掌握异常处理：最佳实践和常见陷阱

php中文网 2024-10-15 12:03:42

异常处理是软件开发的重要组成部分，但它经常被低估、误用或忽视。对于经验丰富的开发人员来说，了解如何有效处理异常可以显着提高代码的健壮性、可维护性和整体系统的可靠性。这篇博文深入探讨了高级异常处理策略、常见错误以及超越编程语言的最佳实践，尽管许多示例将引用 java。

异常处理的哲学

在深入了解细节之前，让我们重新审视一下异常的目的：它们的存在是为了发出异常情况信号，而您的代码在设计时并未将其作为正常操作的一部分进行处理。异常处理是指定义出现这些意外情况时程序的行为方式。

异常不适用于流量控制

最常见的错误之一是使用异常作为常规控制流的机制，尤其是对于新开发人员或从其他范例过渡的开发人员。这可能会导致性能问题、代码不可读以及难以遵循或维护的逻辑。

例如：

try {
    for (int i = 0; i 



<p>这是对异常的滥用。循环应该通过标准检查来管理其边界，而不是依赖于捕获异常。抛出和捕获异常的成本比较高，而且这样做会掩盖代码的实际逻辑。</p>

<h3>
  
  
  <strong>只捕捉你能处理的东西</strong>
</h3>

<p>捕获异常而不正确处理它们是另一个陷阱。您是否经常看到代码捕获通用异常只是为了记录它并继续，或者更糟糕的是，捕获异常只是为了默默地吞掉它们？<br></p>

<pre class="brush:php;toolbar:false">try {
    // some code that might throw an exception
} catch (exception e) {
    // log and move on
    logger.error("something went wrong", e);
}

虽然日志记录很重要，但您应该只捕获您知道如何处理的异常。如果在没有明确的恢复路径的情况下捕获异常，可能会导致隐藏的错误并使诊断问题变得更加困难。

最佳实践：如果当前层代码无法有效地从异常中恢复，则让异常在调用堆栈中向上传播。这允许更高级别的组件（可能有更多上下文）决定最佳的行动方案。

设计的弹性和可读性

快速失败，尽早失败

健壮软件的原则之一是“快速失败”。这意味着当检测到错误时，应该立即报告，而不是让系统在无效状态下继续运行。

例如，如果出现问题，尽早验证方法输入可以防止进一步处理：

public void processorder(order order) {
    if (order == null) {
        throw new illegalargumentexception("order cannot be null");
    }

    if (!order.isvalid()) {
        throw new orderprocessingexception("invalid order details");
    }

    // continue processing the order
}

通过尽早验证假设，您可以防止系统执行不必要的操作并在以后遇到更深层次、更模糊的问题。

明智地使用检查与非检查异常

在像 java 这样的语言中，有检查异常和非检查异常。检查异常强制调用者处理它们，而未检查异常（runtimeexception 的子类）则不会。他们之间的选择应该经过深思熟虑。

检查异常： 当调用者可以合理地预期从异常中恢复时使用这些异常。它们适用于操作失败是其生命周期的正常预期部分的场景，例如可能找不到文件的文件 i/o 操作。
未检查异常：这些更适合正常情况下不应捕获的编程错误，例如空指针取消引用、非法参数类型或违反业务逻辑不变量。

过度使用检查异常可能会导致方法签名臃肿，并强制调用者进行不必要的错误处理，而过度使用未检查异常可能会导致不清楚哪些方法可能会失败以及在什么情况下失败。

单一责任原则

应该在有足够上下文来适当管理异常的情况下进行处理。这与单一职责原则 (srp) 相关，该原则规定类或方法应该只有一个更改理由。异常处理可以被视为一个单独的职责；因此，您的代码应该将异常处理委托给能够完全理解和管理故障的组件。

例如，低级数据库访问代码不一定要处理数据库连接问题本身，而是应该抛出一个异常，由更高级别的服务处理，该服务可以决定是否重试操作、回退到辅助服务系统，或通知用户。

有意义的异常消息

抛出异常时，尤其是自定义异常时，请提供清晰且内容丰富的消息。此消息应该以帮助开发人员（有时还有用户）了解问题所在的方式描述问题。

throw new illegalstateexception("unable to update order because the order id is missing");

这比：
好得多

throw new illegalstateexception("order update failed");

精心设计的消息使调试变得更加容易，并减少诊断问题所花费的时间。

要避免的常见反模式

1.吞咽异常

如前所述，捕获异常而不对其进行任何处理是一种主要的反模式。这不仅隐藏了问题，还可能导致意外行为。

try {
    // risky code
} catch (exception e) {
    // do nothing
}

提示：如果您捕获异常，请确保您正在增加价值。要么处理异常，将其包装在更有意义的异常中，要么重新抛出它。

2.捕获顶级异常

广泛捕获异常或 throwable 可以掩盖不同类型的错误，包括您可能意想不到的未经检查的异常，例如 nullpointerexception 或 outofmemoryerror。

try {
    // risky code
} catch (exception e) {
    // handle all exceptions the same way
}

提示：具体说明您捕获的内容，如果您必须捕获广泛的异常，请确保您理解并能够正确处理它可能包含的各种异常。

3.忽略 interruptedexception

使用线程时，经常会遇到 interruptedexception。忽略它或重新抛出它而不重新中断线程是另一个常见错误。

try {
    thread.sleep(1000);
} catch (interruptedexception e) {
    // log and move on
}

提示：如果捕获了interruptedexception，一般应该重新中断线程，以便正确处理中断：

catch (interruptedexception e) {
    thread.currentthread().interrupt(); // restore the interrupted status
    throw new runtimeexception("thread was interrupted", e);
}

异常处理的高级技巧

1.利用自定义异常来处理特定于域的错误

自定义异常可以提供更清晰的信息并封装特定于域的错误信息。这在大型系统中特别有用，因为相同的异常在不同的上下文中可能有不同的含义。

public class invalidorderstateexception extends runtimeexception {
    public invalidorderstateexception(string message) {
        super(message);
    }
}

这样，异常本身就携带了有关错误上下文的有意义的信息，并且您可以使用异常类型来区分不同的错误情况。

2.使用异常链

异常链允许您将较低级别的异常包装在较高级别的异常中，同时保留原始异常的堆栈跟踪。当您想要在更高级别提供更多上下文而不丢失原始错误信息时，这非常有用。

try {
    // some code that throws sqlexception
} catch (sqlexception e) {
    throw new dataaccessexception("failed to access the database", e);
}

这样，原始的 sqlexception 就会被保留，并且可以在需要时进行检查，但更高级别的异常提供了有关更高抽象级别上发生的情况的附加上下文。

3.在适当的地方集中处理异常

在某些架构中，将异常处理集中在一个位置是有益的，例如 web 应用程序中的全局异常处理程序。这使您可以在一个地方处理常见问题，例如日志记录、错误响应格式或重试。

例如，在 java 中，spring mvc 允许使用 @controlleradvice 注释进行全局异常处理程序：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(DataAccessException.class)
    public ResponseEntity<string> handleDatabaseException(DataAccessException e) {
        // Log and respond appropriately
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage());
    }
}
</string>