2026-05-18-19-46-56 强制刷新样例视频缓存

工程分析/经验记录.md

@@ -105,3 +105,15 @@ B. 产生问题原因：内置样例视频由 OpenCV 直接写出，编码为 `m
 C. 解决问题方案：修改样例生成脚本，生成后用 `ffmpeg` 转码为 `libx264`、`yuv420p`、`faststart` MP4；前端视频加载后调用 `load()` 并在 metadata 加载后轻微 seek 到 `0.1s`。
 
 D. 后续如何避免问题：面向网页播放的样例视频统一转为 H.264/yuv420p，并用 Chrome 实际播放或截图验证，而不是只验证 OpenCV 能读取。
+
+## 2026-05-18-19-46-56 样例视频旧缓存处理
+
+### 1. 修复编码后用户仍看到黑色视频
+
+A. 具体问题：样例视频已转为 H.264 后，用户点击“加载样例”仍然反馈左侧原始视频没有画面。
+
+B. 产生问题原因：实测 Chrome 自动点击流程可以看到画面，视频元素 `readyState=4` 且 `videoWidth/videoHeight` 正常；用户端仍异常更可能是浏览器继续使用旧 `mp4v` 样例缓存。
+
+C. 解决问题方案：后端 `/api/samples` 返回带 `mtime_ns` 的版本化 URL；前端加载样例时追加时间戳，并使用 `fetch(..., { cache: "reload" })` 强制绕过旧缓存。
+
+D. 后续如何避免问题：静态样例、模型文件、前端资源发生兼容性修复时，URL 必须版本化，避免用户浏览器继续使用旧缓存。