背景

项目开发在做单元测试， 发现跑测试 cases 的时候，每一个跑完，日志后都带有一个 (cached) 的标志。尽管代码的实现已经做了修改（比如返回不同数据）， 但是发现再次执行 go test -v case_test.go ，返回跟上一次的结果居然一致，实际上这样的测试是没多少意义的。 之前没有了解过 go test 的原理， 这里想看下了内部是怎么 run 的，以及要怎样禁用测试缓存。

问题分析

Go 官方文档详细说明了 test 包的工作原理：在执行 go test 时会编译每个包和所有后缀匹配 *_test.go 命名的文件（这些测试文件包括一些单元测试和基准测试），链接和执行生成的二进制程序, 然后打印每一个测试函数的输出日志。

Go test 支持两种模式：

  1. Local directory mode, 在调用 go test 时，没有加参数 (比如 go test 或 go test -v)。在这种模式下，缓存会被禁用。 会编译当前目录下的代码和测试，然后运行测试二进制程序。
  2. Package list mode，执行 go test时，指定文件路径 (比如 go test math, go test ./...)。在这种模式下，会编译并测试路径列出的每个测试文件。go test 会缓存成功的测试结果，以避免不必要的重复运行测试。当再次执行测试时，会检查缓存中对应的测试结果是否 OK, 如果 OK 会重新显示之前的输出，而不会运行测试二进制文件。此时 go test 会打印 ‘(cached)’ 标识。

回过头来再看下项目的测试脚本：

1

CGO_ENABLED=1 go test -v --mod=vendor ./pkg/...

运行在 Package list mode, 所以单测通过后的二次测试， 会走 cache。

解决方案

有以下三种方式， 在测试中禁用缓存：

  1. 执行 go test 添加 --count=1 参数（推荐，效率高），以上面👆例子：

    1

    CGO_ENABLED=1 go test -v --count=1 --mod=vendor ./pkg/...

  2. Go 官方提供 clean工具，来删除对象文件和缓存文件， 不过这种方式相对麻烦：

    1

    go clean -testcache // Delete all cached test results

  3. 设置 GOCACHE 环境变量。GOCACHE 指定了 go 命令执行时缓存的路径，以便之后被复用。 设置 GOCACHE=off 即可禁用缓存。

小结

在 Go 项目测试的时候， 还是要多关注 go test 的行为表现，如果单测的结果跟实际有出入， 那么得考虑下使用 go test的姿势对不对， 或者忘记加了参数。

参考