diff --git a/docs/security/admin-models-blank-page-fix.md b/docs/security/admin-models-blank-page-fix.md new file mode 100644 index 0000000..3bd07ac --- /dev/null +++ b/docs/security/admin-models-blank-page-fix.md @@ -0,0 +1,70 @@ +# /admin/models 空白页问题诊断与修复 (#959) + +## 表面症状 +用户报告:访问 https://ai.qihuyun.com/admin/models 浏览器显示完全空白(只有书签栏)。 + +## 完整诊断结果 +所有服务端组件均正常: +1. **nginx** → 返回 544 bytes 七虎AI SPA 入口(正确) +2. **JS bundles** → 全部 200 OK 加载(index-BJo6S9Cm.js 78KB / react-vendor 165KB / Models chunk 19KB) +3. **CSS** → 19855 bytes 完整 admin-* 规则 +4. **后端 admin API** → 用 Bearer token 全部 200 OK +5. **路由配置** → /admin/models → AdminLayout + AdminModels 正确 + +## 真正的根因 +**用户的 Chrome 浏览器缓存了修复 nginx root 之前的旧版本 index.html**。 + +时间线: +1. 修复前:`/` 等路径返回 615 bytes nginx welcome(没有 root 指令,SPA fallback 走 nginx 默认路径) +2. 用户访问 `/admin/models` → 浏览器缓存 615 bytes 旧 index.html (ETag 6a3bc44b-8a) +3. **#957 修复 nginx root**(09:55)→ 现在 nginx 返回正确的 544 bytes 七虎AI SPA +4. **但用户浏览器没刷新**,缓存仍指向 615 bytes 旧版本 +5. 即使现在服务端返回正确 SPA,浏览器仍然使用 disk cache 中的 615 bytes +6. 加载 JS bundle 失败(旧 index.html 不含正确 `