fquiz/memory/2026-06-09.md

Work Log - 修复 Buildx 安装阶段访问 Docker Hub 超时（2026-06-09）

• 背景：

  • GitHub Actions run 27150975287 在 build-and-push job 的 安装 Buildx 步骤失败，后续镜像构建与部署全部被跳过。
  • check-run annotation 给出的精确错误为：
    • Head "https://registry-1.docker.io/v2/moby/buildkit/manifests/buildx-stable-1" ... Client.Timeout exceeded while awaiting headers
  • 根因不是仓库镜像构建脚本本身，而是 docker/setup-buildx-action 默认 docker-container 驱动在启动 BuildKit builder 时，需要先从 Docker Hub 拉 moby/buildkit:buildx-stable-1，受外网访问抖动影响直接超时。

• 本次处理：

  • .github/workflows/main.yml
    • actions/checkout 升级到 v6。
    • docker/setup-buildx-action 升级到 v4，并显式指定：
      • driver-opts: image=docker.m.daocloud.io/moby/buildkit:buildx-stable-1
      • 避免 Buildx 初始化再访问 Docker Hub 拉默认 BuildKit 镜像。
    • docker/login-action 升级到 v4。
    • docker/build-push-action 升级到 v7。
  • 兼带收益：
    • 消除了该次 run 中出现的 Node.js 20 actions are deprecated 预警里的旧版 checkout/setup-buildx。

• 验证：

  • 基线：
    • GitHub Actions run 27150975287 失败，且失败点固定在 安装 Buildx。
    • check-run annotation 可复核到 Docker Hub moby/buildkit 拉取超时。
  • 修改后：
    • python3 解析 .github/workflows/main.yml 通过。
    • actionlint 校验变更前/变更后 workflow 均可解析，变更未引入 YAML / Actions 语法问题。
    • git diff --check -- .github/workflows/main.yml 通过。
  • 当前环境限制：
    • 无法直接在本地实际执行 GitHub hosted runner 上的 setup-buildx 拉起流程，真实恢复效果需要依赖下一次 Actions 运行确认。

• 风险与关注点：

  • 本次修复只绕开 BuildKit builder 镜像对 Docker Hub 的依赖；后续若 Dockerfile 里的基础镜像或 docker build --pull 仍指向不稳定上游，构建阶段仍可能出现其他网络相关失败。