# /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 不含正确 `<script>` 引用)
7. **页面完全空白**

## 修复方案
将 `index.html` 的缓存策略从 `no-cache` 升级为 `no-store` + `Expires: 0`,**强制浏览器每次都重新下载** index.html:

```nginx
location = /index.html {
    add_header Cache-Control "no-store, no-cache, must-revalidate";
    add_header Pragma "no-cache";
    add_header Expires "0";
    try_files /index.html =404;
}
```

**关键差异**:
- `no-cache`: 缓存但每次重新验证(304 协商)
- `no-store`: **完全不缓存**(每次重新下载)
- `Expires: 0`: 旧版 HTTP/1.0 兼容

## 用户操作指引
用户应:
1. 强制刷新浏览器:`Ctrl + Shift + R` (Windows/Linux) 或 `Cmd + Shift + R` (Mac)
2. 或在 DevTools → Network → Disable cache
3. 或清浏览器缓存(通常 `Ctrl + Shift + Delete`)
4. 然后重新访问 `https://ai.qihuyun.com/admin/models`

之后 nginx 返回的 `no-store` 头确保每次访问都拉取最新版 SPA。

## 调试教训沉淀
- **修复 nginx root 后,必须配 `no-store`** 才能保证浏览器不缓存旧 615 bytes nginx welcome
- 否则用户会看到旧版 (615 bytes) + JS bundle 加载失败 = 空白页
- 这是 nginx root 修复的**必须配套措施**

## 验证
| 头部 | 值 |
|------|-----|
| HTTP | 200 OK |
| Content-Length | 544 bytes |
| Cache-Control | no-store, no-cache, must-revalidate |
| Pragma | no-cache |
| Expires | 0 |
| ETag | 6a788336-220(不变,但不再用作缓存协商) |

## 历史
- #957 (2026-08-11 08:55): 加 server 级 `root /app/frontend/dist;` 让 SPA 入口正确
- #959 (2026-08-11 09:18): 加 no-store 让浏览器不缓存旧版本