CI中go test失败主因是环境差异：本地依赖（如PostgreSQL、.env）缺失，需显式启动服务并检查就绪；临时目录用t.TempDir()；配置通过构造函数注入；时间敏感逻辑用mock；必加-mod=readonly、-p=1、-count=1、-timeout=60s、-v参数；覆盖率需-covermode=count、聚合校验阈值；-race仅限关键包且需调高超时；go mod download预热+GOPROXY=direct防网络抖动。
CI里跑go test不是本地命令复制粘贴就能过，漏掉-mod=readonly、没清GOCACHE、不加-timeout，十有八九在PR合并前五分钟才爆。
为什么本地通过的测试在CI里panic或连接拒绝
根本不是代码问题，而是环境假设崩了：数据库没启、端口被占、/tmp不可写、Go版本小更新导致net/http超时行为变化。CI节点是干净容器，没有你的.env、没有本地PostgreSQL、也不认识你硬写的localhost:5432。
- 所有外部依赖必须显式启动——用
services:起PostgreSQL容器，并配合wait-for-it.sh或net.DialTimeout检查就绪，别sleep 5 - 临时目录统一用
t.TempDir()（Go 1.16+），它自动注册清理且路径在容器内有效 - 配置注入别碰
os.Getenv，改用构造函数传参；测试时直接new一个带mock值的实例 - 时间敏感逻辑（如token过期）用
clock.WithMock或gock拦截time.Now()，否则CI时间漂移会引发随机失败
CI中必须加的go test参数组合
默认行为在CI里全是坑：-p=4并发可能争抢临时文件，缓存让失败测试“假装通过”，go.mod被悄悄改写直接报错cannot find module providing package。
-
-mod=readonly（推荐）或-mod=vendor：防止CI因权限不足无法写go.mod而失败；若用vendor/，确保它已提交 -
-p=1：强制串行，排除竞态干扰，尤其调试阶段 -
-count=1：禁用测试结果缓存，避免状态污染掩盖问题 -
-timeout=60s：防止单个HTTP或DB测试挂起整个Job（集成测试可提到120s） -
-v：必须加，否则失败时只看到PASS，实际log.Fatal已静默退出
覆盖率报告生成与校验不能只靠coverage.out
go test -coverprofile=coverage.out只生成原始数据，CI平台看不懂，而且多包聚合时路径解析容易错乱——工作目录和GOPATH不一致会导致HTML报告行号偏移、点不开源码。
立即学习“go语言免费学习笔记（深入）”；
- 用
-covermode=count（非atomic）：计数模式更准，支持跨包聚合 - 合并多个子目录profile：先各包分别生成
coverage-*.out，再用gocovmerge或go tool cover -func=查看函数级覆盖 - 校验阈值：用
grep -q 'total.*[0-9]\{1,3\}\.[0-9]\{1,2\}%' coverage.out检查是否≥80%，不达标exit 1 - 上传到Codecov：确保
codecov-action读的是根目录下coverage.out；多模块项目需用flags参数区分
-race不是全量开就完事，得卡资源和范围
-race会让程序慢2–5倍、内存翻倍，CI默认60分钟超时大概率不够，尤其含集成测试时，还可能OOM崩溃。
- 仅对关键包启用：
go test -race ./internal/worker/，别扫./全量 - CI runner内存必须≥4GB，否则-race直接OOM
- 超时阈值要调高：GitHub Actions设
timeout-minutes: 90 - 别在同一个Job里既跑
-race又跑覆盖率——资源冲突，建议拆成两个独立Job
最常被忽略的其实是go mod download预热和GOPROXY=direct的组合：CI里不预拉依赖，go test边跑边下，网络抖动就超时；不锁代理，私有模块直接拉不到。这两步不在go test命令里，但缺一不可。
