如何测试一个函数是否未被调用（Go 单元测试超时与状态断言实践）-Golang-PHP中文网

如何测试一个函数是否未被调用（Go 单元测试超时与状态断言实践）

本文介绍在 Go 单元测试中验证异步函数是否被调用的两种核心方法：同步场景下直接检查状态变量，异步场景下结合 channel 与 select + time.After 实现可控超时断言，避免测试永久阻塞。

本文介绍在 go 单元测试中验证异步函数是否被调用的两种核心方法：同步场景下直接检查状态变量，异步场景下结合 channel 与 `select` + `time.after` 实现可控超时断言，避免测试永久阻塞。

在 Go 测试中，验证“某个函数未被调用”本身不是直接目标；更合理、可测的断言是：“在预期条件下，该函数应被调用一次”。若它未触发，则说明逻辑或条件判断存在缺陷。关键在于设计可观察、可中断、可断言的测试模式。

✅ 同步调用：用闭包状态变量快速断言

当 c.Start() 是同步执行（即立即调用传入的 trigger 函数）时，最简洁的方式是使用闭包捕获并修改测试作用域内的布尔变量：

func TestFd_Sync(t *testing.T) {
    functionCalled := false
    trigger := func(i int) {
        functionCalled = true
    }

    c := &fd.Fdcount{Interval: 1, MaxFiles: 1}
    c.Start(trigger) // 假设此调用立即执行 trigger

    if !functionCalled {
        t.Fatal("expected trigger function to be called synchronously, but it was not")
    }
}

✅ 优点：零依赖、无竞态、断言清晰、执行迅速。
⚠️ 注意：仅适用于 Start() 内部不启动 goroutine 或不延迟执行的场景。

⏱ 异步调用：用带超时的 select 防止死锁

若 c.Start() 启动后台 goroutine 并按间隔（如每 1 秒）检查条件后调用 trigger，则必须引入超时机制——否则 会无限等待，导致测试挂起。推荐使用 <code>select + time.After 模式：

func TestFd_Async(t *testing.T) {
    called := make(chan struct{}, 1) // 缓冲 channel，避免 sender 阻塞
    timeout := time.After(2 * time.Second) // 设定合理超时（略大于 Interval）

    trigger := func(i int) {
        called <p>✅ 优势：  </p>

超时精确可控，避免 CI 环境卡死；
struct{} 类型 channel 更语义化（仅传递事件，不携带数据）；
缓冲大小为 1 可防止 trigger 在测试结束前因 channel 满而 panic。

? 补充建议与最佳实践

不要复用全局 channel：原示例中 cha 是包级变量，易引发测试间干扰和竞态。务必在每个测试函数内创建独立 channel 或状态变量。
超时时间需合理：设为 Interval * 2 或固定安全值（如 2–3 秒），避免因 CI 负载波动导致偶发失败。
考虑边界条件：补充测试 MaxFiles 不满足、Interval 为 0 等场景下 trigger 是否确实不被调用——此时应断言 !functionCalled（配合同步 mock 或记录日志）。
进阶替代方案：对复杂异步流程，可使用 testify/assert 或 gomega 提供的 Eventually() 断言，但标准库 select 已足够轻量可靠。