proxy_ignore_headers Cache-Control Expires;   ← ① Nginx 自己内部用  # 忽略后端返回的缓存头
add_header X-Cache-Status $upstream_cache_status;  ← ② 返回给客户端的

# 一条命令搞定：看响应头中的缓存状态
curl -sk https://zhoujiayi.xyz/videos -D - -o /dev/null 2>&1 | grep x-cache
-s:不显示进度条和错误信息;-k：跳过 SSL 证书验证
-D：表示只输出响应头（response headers）；- 表示输出到屏幕
-o /dev/null：正文扔垃圾桶
2>&1：把错误信息塞进正确信息里
| grep x-cache：筛选出包含 x-cache 的行

# 输出示例
# x-cache-status: HIT
# x-cache-status: MISS
# x-cache-status: BYPASS

# 查看当前视频缓存的 TTL
grep "proxy_cache_valid" /etc/nginx/conf.d/ops-platform.conf

# 修改 TTL（例如 300s → 600s）
sed -i 's/proxy_cache_valid 200 300s;/proxy_cache_valid 200 600s;/' /etc/nginx/conf.d/ops-platform.conf

# 检查 Nginx 配置语法
nginx -t

# 热重载 Nginx（不中断现有连接）
nginx -s reload

# 查看最近几条请求日志
tail -5 /var/log/nginx/access.log

# 统计缓存命中次数
grep -c " HIT" /var/log/nginx/access.log
grep -c " MISS" /var/log/nginx/access.log
grep -c " BYPASS" /var/log/nginx/access.log

# 看实时请求（持续跟踪）
tail -f /var/log/nginx/access.log

# 查看 Nginx 错误日志（排查 403/500 等问题）
tail -20 /var/log/nginx/error.log

# 查看静态文件是否能正常加载
curl -skI https://zhoujiayi.xyz/static/css/style.css

# 检查文件路径权限链
namei -l /root/note-center/static/css/style.css

# 修复权限（Nginx 以 nginx 用户运行，需要能进入路径）
chmod o+rx /root

# 模拟 Range 请求（视频拖进度条）
curl -sk https://zhoujiayi.xyz/static/css/style.css -H "Range: bytes=0-1024" -D - -o /dev/null 2>&1 | grep -i "http/\|content-range"

# 视频列表页：5 分钟缓存
location /videos {
    proxy_cache micro_cache;  # 使用上面定义的缓存区
    proxy_cache_key "$scheme$host$request_uri";
    proxy_cache_valid 200 300s; # 200 状态的响应缓存 300 秒
    proxy_cache_valid 404 5s;
    proxy_cache_use_stale error timeout updating;
    proxy_cache_lock on;
    proxy_ignore_headers Cache-Control Expires;
    proxy_pass http://flask_backend;
    add_header X-Cache-Status $upstream_cache_status;
}

# 缓存配置与排错指南（内容稳定，10 分钟缓存）
location ~ ^/(video-cache|video-troubleshooting) {
    proxy_cache micro_cache;
    proxy_cache_valid 200 600s;
    ...
}

proxy_cache_path /var/cache/nginx/micro levels=1:2 keys_zone=micro_cache:5m max_size=256m inactive=5m;

# ① 看缓存是否命中
curl -sk https://zhoujiayi.xyz/videos -D - -o /dev/null 2>&1 | grep x-cache

# ② 看当前 TTL 配置
grep "proxy_cache_valid" /etc/nginx/conf.d/ops-platform.conf

# ③ 看日志中的 HIT/MISS 统计
grep -c " HIT" /var/log/nginx/access.log
grep -c " MISS" /var/log/nginx/access.log

# ④ 看最近请求
tail -5 /var/log/nginx/access.log

### 1、问题现象

   在 Note Center 编辑笔记 → 点保存 → 页面重定向回笔记页 → 显示的还是旧内容。
   `Ctrl+F5` 无效，curl 查却能拿到新内容。

###2、排查步骤
第一步：确认是不是你自己电脑的问题
  按 Ctrl + F5（或 Cmd + Shift + R）硬刷新一次。
  - 如果变新内容了 → 就是浏览器缓存了旧页面
  - 如果还是旧的 → 往下走
第二步：确认 Nginx 是否缓存了旧页面
  在命令行跑一次，不走浏览器：
  curl -sk https://zhoujiayi.xyz -D - -o /dev/null 2>&1 | grep -i x-cache
  看输出是 HIT 还是 MISS 还是没内容。
  - 没有 x-cache（或 -） → 说明没走缓存层，往下走
  - HIT → 说明 Nginx 返回了它缓存里的旧页面
  - MISS / EXPIRED → 说明 Nginx 没有缓存或已过期，往下走
第三步：确认页面内容到底更新了没有
  curl -sk https://zhoujiayi.xyz | grep '你改的文字（取一小段）'
  - 如果搜到新文字 → 后端已经更新了，问题在前端（浏览器缓存或 CDN）
  - 如果还是旧文字 → 后端确实没更新，问题出在保存环节
第四步：找到问题所在
curl 搜到新文字，浏览器是旧的——浏览器缓存——Ctrl+F5 就行
curl 搜到新文字，但 x-cache 显示 HIT——Nginx 缓存没过期——清 Nginx 缓存
curl 也是旧文字——根本没保存成功——检查保存逻辑或数据库

### 3、请求链路还原
grep '/note/38' /var/log/nginx/access.log | tail -10

   ```
  01:19:55  ← 你看笔记 → /note/38 → HIT（Nginx 缓存了旧版本，有效期 10 分钟）
  01:20:04  ← 进编辑页 → /note/38/edit
  01:22:19  ← 点保存 → 302 跳到 /note/38?saved=1 → MISS（拿到了新内容）
             但此刻 /note/38（不带 ?saved=1）的旧缓存还在！
  01:21:39  ← 刷新 /note/38（没参数）→ 全 HIT → 旧内容
  01:25:24  ← 10 分钟后缓存过期了 → EXPIRED → 拿到新内容
   ```

### 4、根因分析
浏览器发请求到 Nginx → Nginx 看自己的缓存还有效（HIT）→ 直接返回旧的 → 浏览器收到旧内容。Ctrl+F5 只清你浏览器的缓存，Nginx 服务器上的 proxy_cache 它管不着。
第二次保存的时间点，10 分钟缓存已经过期了（01:25:24 已经开始 EXPIRED 了），所以浏览器拿到的是新数据。
   1. 第一次保存，Flask 写数据库，返回 302 重定向到 `/note/38?saved=1` (?saved=1改变页面内容/行为)
   2. /note/38 之前已经缓存了 10 分钟
   3. `?saved=1` 改变了缓存 key，所以 `/note/38?saved=1` 能拿到新内容
   4. 但 `/note/38`（不带参数）的旧缓存条目还活着（TTL 10 分钟）
   5. 任何对 `/note/38` 的请求依然命中旧缓存
   6. `Ctrl+F5` 只清浏览器缓存，管不到 Nginx 的服务端缓存

### 解法

● 方案一（推荐）**：在笔记 location 也加上 saved=1 的 bypass：

   ```nginx
   location ~ ^/note/\d+$ {
       proxy_cache micro_cache;
       proxy_cache_valid 200 600s;
       proxy_cache_valid 404 5s;
       proxy_cache_use_stale error timeout updating;
       proxy_cache_lock on;
       proxy_ignore_headers Cache-Control Expires;

       # 保存/删除/恢复后跳过并清缓存
       set $cache_bypass "";
     nginx: configuration file /etc/nginx/nginx.conf test is successful

  Thought for 1s (ctrl+o to expand)

● 方案二：
该proxy_cache_valid
  - /note/ 缓存时间：~~600s~~ → 200s
  - 配置检查通过，已重新加载

  保存笔记后最多等 200 秒（3 分 20 秒），缓存就会过期，刷新就能看到新内容了。