根本原因是环境不一致：ci未启用go module proxy或goproxy为空导致依赖问题，goos/goarch未显式指定引发系统调用差异；需显式设置goproxy、go mod download、统一go test -race -coverprofile=coverage.txt ./...命令，并避免端口硬编码、docker入口路径错误及gin健康检查缺失head路由。
GitHub Actions 中 go test 失败但本地通过，怎么定位？
根本原因通常是环境不一致：CI 默认不启用 Go module proxy，或 GOPROXY 设置为空，导致依赖拉取失败或版本漂移；另外 GOOS/GOARCH 未显式指定时，Actions runner 可能用默认值（如 linux/amd64），而本地是 darwin/arm64，某些测试逻辑（比如文件路径、系统调用）会行为不同。
实操建议：
- 在 workflow 中显式设置
GOPROXY: https://proxy.golang.org,direct，避免私有模块被跳过 - 所有
go test步骤前加go mod download，确保依赖完整且可复现 - 测试命令统一用
go test -race -coverprofile=coverage.txt ./...，-race能暴露 Gin handler 里 goroutine 共享 map 或未加锁变量的问题 - 如果测试含 HTTP 请求（比如用
httptest.NewServer），确保端口绑定逻辑不硬编码:8080，改用port := freePort()类辅助函数，避免端口冲突
Docker 构建时 “exec: "main": executable file not found in $PATH” 怎么修？
这是最典型的 Dockerfile 入口路径错误。Gin 服务编译后生成的二进制文件没放在镜像 $PATH 下，或者 CMD 指向了错误路径。
实操建议：
- 构建阶段用
CGO_ENABLED=0 go build -o /app/service .，把输出路径写死为绝对路径，避免相对路径歧义 - Dockerfile 中明确
COPY ./bin/service /app/service（如果你用 Makefile 输出到bin/）或直接COPY . .后在容器内go build（不推荐，破坏分层缓存） -
CMD ["/app/service"]必须是绝对路径，不能写CMD ["service"]—— Alpine 镜像默认没有/usr/local/bin在$PATH里 - 加一行
RUN ls -l /app/到构建步骤末尾，CI 日志里一眼确认二进制是否存在、权限是否为-rwxr-xr-x
Gin 的 /health 端点在 Kubernetes 里总被探针标记为失败，为什么？
Kubernetes livenessProbe 和 readinessProbe 默认用 HTTP GET，但 Gin 默认路由不处理 HEAD 请求 —— 而 kubelet 探针底层会发 HEAD，若 handler 没注册，返回 404，探针就判定失败。
实操建议：
- 不要只写
r.GET("/health", healthHandler)，补上r.HEAD("/health", healthHandler) - handler 内部避免耗时操作（比如 DB ping），Kubernetes 默认超时 1 秒，超时即重启；用
context.WithTimeout包裹检查逻辑 - 区分
/live和/ready：/live 只检查进程存活（返回 200 即可），/ready 检查依赖（DB、Redis 连通性），避免滚动更新时流量打到未就绪实例 - 在 deployment.yaml 中显式配置
initialDelaySeconds: 10，给 Gin 启动留出时间，尤其当有 sync.Once 初始化逻辑时
GitHub Actions 部署到 K8s 时镜像 tag 用 latest 还是 commit hash？
用 ${{ github.sha }}，永远别用 latest。后者会导致 kubectl apply 无法感知镜像变更，K8s 认为 Deployment 没变，就不会触发滚动更新 —— 你推了新代码，线上还是旧版。
实操建议：
- 构建镜像时用
docker build -t ${{ secrets.REGISTRY }}/api:${{ github.sha }} . - 推送后，在部署步骤中用
kubectl set image deployment/api api=${{ secrets.REGISTRY }}/api:${{ github.sha }}，比全量apply更安全，不会覆盖手动 patch 的字段（比如资源限制） - 如果用 kustomize，把镜像名抽成
images:字段，在kustomization.yaml里用replacements动态注入${{ github.sha }}，而不是拼接字符串 - CI 流水线里加一步
curl -s https://api.github.com/repos/owner/repo/commits/${{ github.sha }} | jq -r '.commit.message'，把本次提交 message 打印到日志，方便回溯发布内容
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
