Go语言错误处理之哨兵错误（Sentinel Error）

如何定义哨兵错误？

在 Go 中，我们可以使用 errors.New() 或自定义错误类型来创建哨兵错误。最常见的方式是在包级别定义一个全局错误变量。

package mainimport (    "errors"    "fmt")var (    ErrInvalidInput = errors.New("invalid input")    ErrNotFound     = errors.New("resource not found"))func processInput(s string) error {    if s == "" {        return ErrInvalidInput    }    if s == "missing" {        return ErrNotFound    }    return nil}func main() {    err := processInput("")    if err != nil {        if err == ErrInvalidInput {            fmt.Println("检测到无效输入！")        } else if err == ErrNotFound {            fmt.Println("资源未找到！")        }    }}

上面的代码展示了如何定义两个哨兵错误 ErrInvalidInput 和 ErrNotFound，并在函数中返回它们。调用者通过 == 比较来判断具体是哪种错误。

哨兵错误的优点

• 简单直观：对于简单的错误分类，哨兵错误非常易于理解和使用。
• 性能高效：指针或值的相等比较非常快。
• 标准库广泛使用：例如 io.EOF 就是一个经典的哨兵错误。

哨兵错误的局限性

尽管哨兵错误在某些场景下非常有用，但它也有一些明显的缺点：

• 无法携带上下文信息：哨兵错误是固定的，不能包含动态信息（如文件名、行号等）。
• 容易被包装破坏：如果你使用 fmt.Errorf("%w", err) 包装哨兵错误，直接使用 == 比较将失败。
• 耦合性强：调用方必须导入定义哨兵错误的包才能进行比较。

为了解决包装问题，Go 1.13 引入了 errors.Is() 和 errors.As() 函数：

import "errors"func main() {    err := processInput("")    wrappedErr := fmt.Errorf("wrapped: %w", err)    if errors.Is(wrappedErr, ErrInvalidInput) {        fmt.Println("即使被包装，也能识别哨兵错误！")    }}

何时使用哨兵错误？

根据 Go错误处理最佳实践，哨兵错误适用于以下场景：

• 错误类型有限且固定（如 EOF、Not Found）。
• 不需要携带额外上下文信息。
• 作为 API 的一部分暴露给外部调用者。

对于更复杂的错误处理需求，建议使用自定义错误类型或结合 errors.Is/As 的方式。

总结

哨兵错误（Sentinel Error）是 Go语言错误处理 中的基础模式之一。它简单、高效，适合处理预定义的、无上下文的错误情况。但在现代 Go 开发中，应结合 errors.Is 来增强其鲁棒性。掌握这一模式，是迈向编写高质量 Go 代码的重要一步。

希望这篇关于 Sentinel Error 的教程能帮助你更好地理解 Go 的错误处理机制。继续实践，你将逐渐形成自己的 Go错误处理最佳实践！