Go语言CI/CD自动化流程_Golang持续集成发布配置-Golang-PHP中文网

GitHub Actions中go test卡住主因是未设超时及遗留goroutine，须加-timeout 60s、用httptest.NewUnstartedServer、跳过真实DB连接；发布失败因路径权限错，需清理dist并设GITHUB_TOKEN写权限；私有模块拉取失败因漏配GOPRIVATE和go.sum缓存key。

go语言ci/cd自动化流程_golang持续集成发布配置

GitHub Actions 跑不起来、测试挂住、二进制发不到 Releases、私有模块拉不到——不是 Go 项目难配 CI/CD，是默认模板漏了关键约束。

go test 在 CI 里卡住或超时，根本原因不是慢，是没设 timeout

本地秒过，CI 里跑一半不动，大概率是测试里起了没关的 http.Server 或 goroutine。GitHub Actions 默认不限制单个命令执行时间（上限 6 小时），但你等不起。

所有 go test 命令必须加 -timeout 60s，别信“我这测试很短”——磁盘 IO、DNS 解析延迟在 CI 环境会被放大
HTTP 测试用 httptest.NewUnstartedServer + srv.Start() + defer srv.Close()，别写 http.ListenAndServe
数据库测试跳过真实连接：用 file::memory: 或 testcontainers-go；若必须连，加 -short
删掉所有 time.Sleep，改用 sync.WaitGroup 或 channel 等待条件达成

交叉编译产物发不到 GitHub Releases，多半是路径或权限没对上

softprops/action-gh-release 只认 ./dist/* 下的文件，且依赖 GITHUB_TOKEN 的 packages: write 权限（默认 workflow token 已带，不用额外配）。

发布前先清空：rm -rf ./dist && mkdir -p ./dist，否则上次残留文件会被一起推上去
构建时显式指定输出名，带平台标识：GOOS=linux GOARCH=amd64 go build -o ./dist/myapp-linux-amd64
确保 on: push: tags 触发，且 tag 是附注型（git tag -a v1.2.3 -m "release"），轻量 tag 不触发 workflow
检查 .github/workflows/*.yml 中是否漏了 permissions: contents: write（新版 Actions 默认不给写权限）

私有模块（如 gitlab.com/org/repo）在 CI 里报 cannot find module

错误信息像 cannot load package: package xxx: cannot find module providing package xxx，本质是 go mod download 阶段找不到私有域名对应的代理或认证配置。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

必须在 job 开头设 GOPRIVATE=gitlab.com/org/*（支持通配），否则 go 命令会强行走 proxy.golang.org
若私有 Git 服务需要认证，加 git config --global url."https://token:x-oauth-basic@github.com/".insteadOf "https://github.com/" 类似配置
go mod download 步骤要放在 go test 之前，避免网络抖动导致超时失败被误判为模块缺失
别依赖 go test ./ 自动扫描——它可能误入含 // +build windows 的目录，在 Linux runner 上失败

缓存没生效，每次重下依赖，CI 耗时翻倍

默认模板常漏掉 go.mod 和 go.sum 的缓存 key 设计，导致即使依赖没变，也反复拉包。

用 actions/cache@v4 缓存 $HOME/go/pkg/mod，key 必须包含 go.sum 的 hash：${{ hashFiles('**/go.sum') }}
别用 stable 当 go-version，它长期不更新；明确写死如 '1.22'，否则 setup-go 可能复用旧版缓存
确保 go mod download 在缓存步骤之后、测试之前运行，且不在 if: steps.cache.outputs.cache-hit != 'true' 分支里绕过
避免在 CI 中执行 go install 到全局——它依赖 GOPATH/bin，而 Actions 默认不设 GOPATH，改用 go build -o ./bin/app