理解 Go Test 的并行机制
在go项目中，当开发者为web api等服务实现多个包并为其编写了独立的测试用例时，通常会遇到一个常见问题：单独运行每个包的测试（例如 go test ./api/pkgname）时测试能够顺利通过，但尝试一次性运行所有包的测试（例如 go test ./api/...）时，测试却频繁失败。这种失败往往表现为“关系/表不存在”等数据库相关的错误，这强烈暗示了测试用例之间存在资源竞争。
问题的根源在于 go test 命令的并行执行策略。Go 测试的并行性可以分为两个层面：
- 包内并行 (Intra-package Parallelism)：由 testing.T.Parallel() 控制，并可通过 go test -parallel N 标志调整。这允许在同一个包内的不同测试函数并行执行。
- 包间并行 (Inter-package Parallelism)：由 go test -p N 标志控制，它决定了可以并行运行多少个包的测试。默认情况下，go test ./... 会尝试并行测试多个包，以加快整体测试速度。
当多个包的测试同时运行时，如果它们都尝试修改或初始化同一个共享资源（例如，通过 DROP SCHEMA public CASCADE 后 CREATE SCHEMA public 来重建数据库模式），就会出现竞态条件。一个包可能在另一个包尝试访问数据之前删除了表，或者在另一个包初始化完成之前开始写入数据，从而导致不可预测的失败。
识别并解决共享资源冲突
在上述场景中，每个测试用例都包含重建整个数据库模式的逻辑。当 go test ./api/... 运行时，Go 测试工具会并行启动多个测试进程，每个进程可能负责一个包的测试。这意味着，不同的包可能同时执行 DROP SCHEMA public CASCADE 和 CREATE SCHEMA public 操作，从而互相干扰，导致数据库状态混乱，最终引发“表不存在”等随机错误。
尝试使用 go test -cpu 1 -parallel 0 ./src/api/... 等标志通常无法解决此问题，因为 -parallel 标志仅控制包内测试的并行性，而问题出在包间的并行执行。
核心解决方案：强制包级别串行执行
为了解决这种包间共享资源冲突，我们需要强制 go test 命令串行执行各个包的测试。这可以通过 go test -p=1 标志来实现。
go test -p=1 命令指示 Go 测试工具一次只运行一个包的测试。当一个包的测试完成后，才会开始下一个包的测试。这样可以确保在任何给定时间点，只有一个包在操作共享资源（如数据库），从而避免了竞态条件和冲突。
示例命令：
go test -p=1 ./api/...
这个命令会遍历 api 目录及其子目录下的所有包，并逐个执行它们的测试。
替代方案与注意事项
虽然 -p=1 是一个直接有效的解决方案，但也有其他方法和需要注意的事项：
-
临时工作区方案： 在某些情况下，开发者可能会采用以下 find 命令作为临时解决方案：
find
-type d -exec go test {} \; 这个命令会找到指定目录下的所有子目录（代表不同的包），然后对每个目录单独执行 go test。它同样实现了包的串行测试，但相比 go test -p=1 而言，它更像是一个外部脚本，而非 go test 工具的内置功能，因此在集成性和通用性上略逊一筹。
测试性能考量： 强制串行执行所有包的测试会显著增加整体测试时间，尤其是在项目包含大量包时。因此，虽然 -p=1 解决了冲突问题，但它牺牲了测试速度。
-
更健壮的测试设计： 从长远来看，解决共享资源冲突的最佳方法是改进测试用例的设计，使其本身具有更好的隔离性。可以考虑以下策略：
- 为每个测试包使用独立的测试数据库或 schema： 确保不同的包在不同的数据库环境中运行，互不干扰。
- 使用事务进行测试设置和清理： 在每个测试函数内部，将数据库初始化和数据插入操作包装在一个事务中。测试结束后，回滚事务，确保数据库状态不被持久化，也不会影响其他测试。
- 模拟（Mocking）外部依赖： 对于数据库等外部依赖，可以考虑在单元测试中进行模拟，只在集成测试或端到端测试中才与真实数据库交互。这可以大大减少对共享资源的依赖，并提高测试速度。
- 使用测试容器： 利用 Docker 等容器技术为每个测试运行或每个测试包提供一个独立的、一次性的数据库实例。
总结
当Go语言的并行包测试因共享资源（特别是数据库）冲突而失败时，最直接有效的解决方案是使用 go test -p=1 ./... 标志来强制包级别的串行执行。这确保了在任何时间点只有一个包在操作共享资源，从而消除了竞态条件。然而，为了提高测试效率和稳定性，建议在可能的情况下，通过改进测试设计来实现更好的隔离性，例如使用独立的测试环境、事务回滚或模拟外部依赖。
