CI中go test失败主因是环境差异：GOPROXY缺失、TempDir权限不足、time.Now()时区漂移、外部服务未容器化或缺健康检查。
go test 在 CI 里总失败？先盯住这四个环境差异点
本地 go test 全绿，CI 里随机挂掉——这不是玄学，是环境没对齐。最常踩的坑就四个：GOPROXY 缺失导致模块拉取超时、os.TempDir() 权限受限让临时文件写入失败、time.Now() 硬断言在不同 TZ 下结果漂移、外部服务（Redis/PostgreSQL）没容器化或没健康检查就直接连。
- 必须显式设置
GOPROXY=https://proxy.golang.org,direct和GOSUMDB=off（或用可信 sumdb），否则模块校验在无缓存的 CI 环境里极易卡死 - 测试里别用
time.Sleep(100 * time.Millisecond)等待，改用可注入的func() time.Time接口，或引入testclock库做时间可控 - 所有外部依赖必须走
docker-compose up -d启动，并在go test前加轮询检查（比如redis-cli -h localhost ping直到返回PONG） - 并发测试务必用
t.Parallel()显式声明，且确保子测试之间无共享状态（比如全局 map、未加锁的计数器）
GitHub Actions 中最简但稳定的 test.yml 怎么写
不用套复杂模板，一个干净的 .github/workflows/test.yml 就够用，重点是分阶段、设超时、区分测试粒度。
name: Test
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up Go
uses: actions/setup-go@v5
with:
go-version: '1.22'
- name: Cache Go modules
uses: actions/cache@v4
with:
path: ~/go/pkg/mod
key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
- name: Run unit tests
run: go test -v -short -timeout 60s ./
- name: Run race detector
run: go test -race -timeout 120s ./
-
-short是关键开关：它让测试跳过耗时长的集成用例，你得在测试函数开头加if testing.Short() { t.Skip() }主动标记 - 缓存
~/go/pkg/mod能省下 30–60 秒依赖下载时间，key 用hashFiles('**/go.sum')保证缓存精准失效 - 不要在 CI 里跑
go test -p=10这类全局并发控制——Go 测试默认已并行，额外设值反而干扰调度
覆盖率报告怎么生成又不拖慢流水线
覆盖率不是越全越好，而是要快、准、可对比。原生 go test -coverprofile 足够，但别让它成为瓶颈。
- 单元测试阶段用
go test -coverprofile=coverage.out -covermode=atomic ./，atomic模式比count更快且线程安全 - 别在同一个 job 里既跑竞态检测又跑覆盖率——
-race和-cover不能共存，得拆成两个独立 step - 上传到 Codecov 时，只传
coverage.out，别传整个目录；用codecov/codecov-action@v4而非 v3，v4 支持更细粒度的文件过滤
为什么集成测试总在 CI 里超时或不稳定
因为“集成测试”这个词在 CI 里容易被滥用——它不该是把所有服务硬编码 localhost 启起来就开跑，而应有明确边界和隔离手段。
- 用
go test -tags=integration单独跑集成测试，避免和单元测试混在一起；在测试文件顶部加//go:build integration构建约束 - 数据库连接字符串必须从环境变量注入（如
DB_URL），禁止写死localhost:5432；CI 里通过env:配置真实容器地址 - 每个集成测试用例结束后，必须清理数据（比如
TRUNCATE TABLE users），或用事务 +Rollback回滚，否则测试间会互相污染
真正难的不是让测试跑起来，而是让每次运行都可复现——环境、依赖、时间、状态，四者缺一不可控，CI 就会变成黑盒。
