github actions 是 golang 微服务最轻量、开箱即用的无服务器 ci/cd 方案，关键在于确保构建可靠可复现：需显式声明 go 版本、提前执行 go mod download、限定测试范围、必加 -race、正确配置 dockerfile 路径与静态链接、用 go.sum 基于 hash 缓存 modules、区分 /live 与 /ready 健康检查端点，并使用 git commit sha 作为镜像 tag。
GitHub Actions 是 Golang 微服务最轻量、开箱即用的无服务器 CI/CD 方案——不用维护 Runner，不依赖私有基础设施，只要代码推到 GitHub，流水线就自动跑起来。关键不是“能不能接入”，而是“怎么让每次构建都可靠、可复现、不踩坑”。
go test 在 CI 里失败，但本地能过？
这是最常遇到的「假成功」：本地 go test 通过，CI 却报 no required module provides package 或竞态超时。根本原因不是代码问题，而是环境不一致。
-
go version必须显式声明：用actions/setup-go@v5指定版本（如v1.22），别信系统默认值 -
go mod download要提前执行：CI 首次拉依赖可能超时，加一步run: go mod download再跑测试 - 测试范围要收窄：
go test ./...会扫vendor/或examples/下的无效包；改用go test ./pkg/ ./cmd/ -timeout 30s - 必加
-race：CI 是暴露竞态的黄金场景，go test -v -race才算真正验证并发安全
Docker 镜像构建后 exec: "main": executable file not found in $PATH
这不是 Go 编译失败，是 Docker 启动时找不到二进制。Golang 微服务容器化部署常见于 Kubernetes，但镜像构建阶段容易忽略路径和权限细节。
openclaw-gitcode-pr-monitor
下载
监控一个或多个 GitCode 仓库的 PR，通过 OpenClaw Gateway 自动执行 AI 审查，发布 PR 评论，并发送钉钉和企业微信通知。
-
Dockerfile中COPY的目标路径必须和ENTRYPOINT一致：比如COPY ./bin/myapp /app/myapp，对应ENTRYPOINT ["/app/myapp"] - 别用
go install：它依赖$GOPATH/bin，CI 环境下路径不可控；坚持用go build -o ./bin/myapp . - 多阶段构建是刚需：第一阶段用
golang:1.22编译，第二阶段用scratch或alpine:latest，只 COPY 二进制，镜像体积能压到 10MB 以内 - 如果用
scratch基础镜像，确保二进制是静态链接：加-ldflags '-extldflags "-static"'，否则启动时报no such file or directory
如何缓存 Go modules 加速 CI？
每次 go mod download 都重拉依赖，不仅慢，还容易因网络抖动失败。GitHub Actions 的 actions/cache 能解决，但 key 和 path 错一点就失效。
- 缓存路径固定为
${{ env.GOPATH }}/pkg/mod（Go 1.14+ 默认启用 module 模式） - key 必须基于
go.sum：用hashFiles('**/go.sum')，不是go.mod—— 因为间接依赖变更只写进go.sum - fallback-keys 要设两层：先按
go.sum匹配，没命中再 fallback 到go.mod，避免首次提交没go.sum就跳过缓存 - 别漏掉
GOCACHE：加一行env: GOCACHE: ${{ runner.temp }}/go-cache，加速go build和go test
部署到 Kubernetes 前，健康检查端点怎么区分？
微服务上线后被 K8s 误杀，往往因为 /healthz 或 /readyz 返回逻辑没拆开。Kubernetes 的 livenessProbe 和 readinessProbe 行为完全不同，混用会导致滚动更新卡死或流量打到未就绪实例。
-
/live只检查进程存活（如能否响应 HTTP），不查 DB 连接；/ready必须检查 DB、Redis、下游依赖是否 ready - K8s 配置里，
livenessProbe初始延迟（initialDelaySeconds）建议 ≥30s，避免启动慢的服务被反复 kill -
readinessProbe失败时，K8s 会从 Service Endpoints 移除该 Pod；所以/ready必须真实反映服务就绪状态，不能只返回200 OK - 镜像 tag 推荐用
git commit SHA（如sha-abc1234），别用latest——配合 Kustomize 的images:字段可精准替换，避免镜像污染
go test 和 CI 是否用同一套 go.sum、Docker 构建是否真的用了多阶段、K8s 的 readinessProbe 是否真在查下游依赖。这些地方一松动，CI 就变成「看起来跑通了，其实没跑对」。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
