fix(ci): Web 镜像 buildx 幽灵缓存防护——Git Tree Hash Cache Bust #1585

Merged

xiaoxia merged 2 commits from fix/buildx-web-cache-bust into develop 2026-08-31 22:40:57 +08:00

Conversation 3 Commits 2 Files Changed 6

+76 -35

xiaoxia commented 2026-08-31 21:09:29 +08:00

Owner

Copy Link

Copy Source

问题

ci-builder-persist 持久化 builder 的 buildkit 层缓存偶尔出现"幽灵命中"：COPY apps/web/ ./ 步骤认为自己没变（实际文件已改），导致 vite build 不执行，打出来的 Web 镜像前端文件是旧的。

修复原理

把 apps/web/ 目录的 git tree hash 作为 build arg 传入 Dockerfile。buildx 把 build arg 值作为缓存键的一部分，hash 变了 → RUN 步骤缓存失效 → vite build 必须重新执行。依赖层（npm ci）不受影响，仍然正常缓存。

改动

1. web.Dockerfile：新增 ARG SOURCE_HASH，在构建步骤写入 .cache_bust 文件
2. docker_build_push.sh：Web 镜像构建时计算 git tree hash 并传入
3. docker_build_only.sh：同上

验证

• 合并后触发 push 到 develop
• 查看 Build Staging Web Image 日志，确认输出 Web cache bust: SOURCE_HASH=xxxxx
• 修改 apps/web/ 下文件再次 push，确认 SOURCE_HASH 值变化且 vite build 执行

## 问题 ci-builder-persist 持久化 builder 的 buildkit 层缓存偶尔出现"幽灵命中"：COPY apps/web/ ./ 步骤认为自己没变（实际文件已改），导致 vite build 不执行，打出来的 Web 镜像前端文件是旧的。 ## 修复原理 把 `apps/web/` 目录的 git tree hash 作为 build arg 传入 Dockerfile。buildx 把 build arg 值作为缓存键的一部分，hash 变了 → RUN 步骤缓存失效 → vite build 必须重新执行。依赖层（npm ci）不受影响，仍然正常缓存。 ## 改动 1. **web.Dockerfile**：新增 `ARG SOURCE_HASH`，在构建步骤写入 `.cache_bust` 文件 2. **docker_build_push.sh**：Web 镜像构建时计算 git tree hash 并传入 3. **docker_build_only.sh**：同上 ## 验证 - 合并后触发 push 到 develop - 查看 Build Staging Web Image 日志，确认输出 `Web cache bust: SOURCE_HASH=xxxxx` - 修改 apps/web/ 下文件再次 push，确认 SOURCE_HASH 值变化且 vite build 执行

xiaoxia added 1 commit 2026-08-31 21:09:29 +08:00

fix(ci): Web 镜像 buildx 幽灵缓存防护——Git Tree Hash Cache Bust ... f34b076dcd

问题：ci-builder-persist 持久化 builder 的 buildkit 层缓存偶尔出现'幽灵命中'：
COPY apps/web/ ./ 步骤认为自己没变（实际文件已改），导致 vite build 不执行，
打出来的 Web 镜像前端文件是旧的。

修复原理：
把 apps/web/ 目录的 git tree hash 作为 build arg 传入 Dockerfile。
buildx 把 build arg 值作为缓存键的一部分，hash 变了 → RUN 步骤缓存失效 →
vite build 必须重新执行。依赖层（npm ci）不受影响，仍然正常缓存。

改动：
1. web.Dockerfile：新增 ARG SOURCE_HASH，在构建步骤写入 .cache_bust 文件
2. docker_build_push.sh：Web 镜像构建时计算 git tree hash 并传入
3. docker_build_only.sh：同上

验证：
- 合并后触发 push 到 develop
- 查看 Build Staging Web Image 日志，确认输出 Web cache bust: SOURCE_HASH=xxxxx
- 修改 apps/web/ 下文件再次 push，确认 SOURCE_HASH 值变化且 vite build 执行

gitea-actions bot commented 2026-08-31 21:17:46 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1585
预览链接	https://pr-1585.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1585 | | 预览链接 | [https://pr-1585.preview.xiaoxiajianji.com](https://pr-1585.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot added 1 commit 2026-08-31 21:32:35 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 148b41a5d6

auto-approve-bot commented 2026-08-31 21:41:27 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR #1585

⚠️ 问题（0个需要修改）

💡 建议（0个可选）

---

✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能无隐患

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-31 13:41:27 | 模型:}

## 代码审查结果 - PR #1585 ### ⚠️ 问题（0个需要修改） ### 💡 建议（0个可选） --- ✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能无隐患 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-31 13:41:27 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit bc9df316dc into develop 2026-08-31 22:40:57 +08:00

gitea-actions bot commented 2026-08-31 22:46:36 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1585 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1585 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1585