如何测试外部包中无法实例化的私有Error类型？

针对外部包未导出错误实例化的问题，以下是几种实用的测试方案：

1. 利用反射构造错误实例 #

Go的反射机制可以绕过未导出限制，直接创建并设置Error结构体的字段：

import (
    "reflect"
    "testing"
)

func TestHandleErr(t *testing.T) {
    // 创建Error类型的实例
    errType := reflect.TypeOf((*Error)(nil)).Elem()
    errInstance := reflect.New(errType).Interface().(*Error)
    
    // 设置未导出的condition字段
    conditionField := errType.FieldByName("condition")
    reflect.ValueOf(errInstance).Elem().FieldByIndex(conditionField.Index).SetBool(true)
    // 可选：设置message字段
    messageField := errType.FieldByName("message")
    reflect.ValueOf(errInstance).Elem().FieldByIndex(messageField.Index).SetString("test error")

    // 传入HandleErr执行测试
    result := HandleErr(errInstance)
    // 编写断言验证结果符合预期
    // ...
}

注意：这种方案依赖外部包的结构体字段名，若外部包后续修改字段名称，测试会失效，属于侵入性较强的临时方案，但在无其他途径时有效。

2. 复用外部包的公开方法生成目标错误 #

检查外部包是否有公开函数（哪怕是间接的）能返回不同condition状态的Error实例：

• 有没有公开的业务逻辑函数，在特定参数下会返回condition=true的错误？
• 是否存在公开接口方法，调用后能生成对应状态的错误？

例如外部包若有如下公开函数：

func DoHighRiskOperation() error {
    return newErrorWithCondition("operation failed", true)
}

测试时直接调用DoHighRiskOperation()就能拿到所需的错误实例，这是最稳妥的方案，依赖的是外部包的公开API，兼容性更强。

3. 模拟Error的公开接口（若适用） #

如果HandleErr仅依赖Error的公开方法（比如IsCondition()）或error接口的Error()方法，可以自行定义模拟类型：

type mockSpecificError struct {
    mockCondition bool
    mockMessage   string
}

func (m *mockSpecificError) IsCondition() bool {
    return m.mockCondition
}

func (m *mockSpecificError) Error() string {
    return m.mockMessage
}

注意：这种方式仅当HandleErr中errors.As的匹配逻辑基于公开接口时有效；如果要求严格匹配外部包的Error类型，则该方案不适用。

4. 黑盒测试：验证外部包公开行为的处理结果 #

若无法直接构造错误实例，可通过测试HandleErr对外部包公开方法返回错误的处理逻辑间接验证：

• 调用外部包返回普通错误（condition=false）的函数，传入HandleErr验证返回结果；
• 调用外部包返回带条件错误（condition=true）的函数，验证对应分支的执行结果。

这种方式无需关心错误内部字段，仅验证业务逻辑的正确性，符合黑盒测试的思想。

内容的提问来源于stack exchange，提问作者Person1