synctest为并发测试推进虚拟时间

用 synctest 推进并发测试里的虚拟时间，需要把测试放进 synctest.Test 创建的 bubble，让其中的协程在可识别的等待点阻塞。测试协程可用 time.Sleep 指定下一个观察点；当 bubble 满足整体阻塞条件时，虚拟时钟自动向前推进。synctest.Wait 用来等待其他协程稳定，并不是任意时长的 Advance 方法。

官方地址：https://pkg.go.dev/testing/synctest

本文使用 Go 1.25 起提供的 Test 与 Wait 接口。Go 官方说明该包在 Go 1.25 已从实验阶段转为正式可用；不要混用 Go 1.24 早期实验示例的入口。例子只关注一个延迟标签任务：三秒期限前没有结果，期限后得到 ready。

先把计时数据放进同一个 bubble

虚拟时间是测试环境里的时间，不是机器时钟被修改。把定时器、结果通道和后台任务在 Test 回调内创建，能让这段测试的依赖集中在同一边界。外部网络服务、外部进程与测试之外的后台协程，会使这个边界变得难以控制。

本例的输入是三秒延迟，计时器保存等待条件，result 保存一次任务结果，done 表示任务退出。结果通道带一个缓冲槽，让后台任务交付结果后可以退出，不必依赖测试协程恰好同时接收。

在期限前后分别读取一次结果

将下面内容保存为模块中的 delay_test.go。计时器在启动后台任务前就已创建，所以三秒期限的起点不依赖后台协程什么时候开始运行。

package delayed

import (
    "testing"
    "testing/synctest"
    "time"
)

func TestDelayedLabel(t *testing.T) {
    synctest.Test(t, func(t *testing.T) {
        // 在 bubble 内创建计时器与结果通道，共享同一虚拟时钟边界。
        timer := time.NewTimer(3 * time.Second)
        defer timer.Stop()
        result := make(chan string, 1)
        done := make(chan struct{})

        go func() {
            defer close(done)
            

开始的 Wait 让后台任务先进入等待状态。随后观察一秒处是否仍无结果，再观察三秒处是否已经得到标签。两个 select 都使用 default 形成非阻塞观察，避免断言本身无意中等待任务完成。

最后的 time.Since 描述 bubble 内的虚拟时间差，不是对测试耗时的基准测试。以上是供读者执行的原创示例及预期判断，本文未将插图或预期结果当作本机运行记录。

# 在已初始化的 Go 模块内，只运行这个示例测试并绕过测试缓存。
go test -run '^TestDelayedLabel$' -count=1

把时间推进与断言同步分开理解

官方规则的核心是：时钟要等 bubble 中协程都进入持久阻塞，才有条件推进；如果有 Wait 等待稳定状态，优先返回这个等待点。这样测试可以先观察“还没发生”，再主动让测试协程睡到后面的观察点。

不要在回调里用不停读取 time.Now 的循环等待期限。忙等仍然在运行，会破坏自动推进所需的空闲条件。也不要把一次普通的调度让步当成稳定状态通知，测试应使用清楚的同步关系来观察结果。

失败时查依赖边界，结束时收回任务

如果测试不能按预期推进，先看是否仍有忙等协程，以及是否把真实网络读写塞进了例子。官方文档将网络 I/O 等等待与 bubble 内可识别的持久阻塞区分开；有必要时，用进程内替身替代外部依赖，而不是给每个断言再加一段真实等待。

本例对定时器使用 Stop，并以 done 等待任务退出。扩展成长期轮询任务时，应设计退出信号，测试结束前让任务响应退出。不要让根回调提前返回后，仍留下依赖未来计时器才能结束的后台工作。

如果将测试结果保存为报告，建议分别记录业务观察点、期望标签和实际断言结果。不要把三秒虚拟时间写成“性能提升三秒”或机器实际耗时，更不要把它当成对所有并发路径都已覆盖的证明。

常见问题

一定要改造业务代码注入假时钟吗？本例直接使用标准 time API，由 bubble 提供虚拟时间；是否还需要额外接口取决于真实依赖与测试范围。

只调用 Wait 能测试未来三秒的结果吗？不能把它当成指定时长推进。先安排测试观察点，再等待相关后台工作稳定，才能区分期限前后的行为。

能用虚拟时间判断真实网络超时性能吗？这个例子用于受控的并发行为测试，真实网络与系统调度性能需要另行设计测量。

参考：synctest 官方包文档、Go 官方并发测试与虚拟时间说明。