文件不显示、上传 413、下载菜单空白：缓存与传输类问题
「明明做了操作，界面却不对劲」——这类问题八成出在缓存、中间层或浏览器插件上。
上传的文件不显示 / 删掉的还在
目录列表有默认 30 分钟的缓存：
- 点右下角刷新按钮强刷当前目录
- 或在添加存储页调短该存储的缓存过期时间
- 后台改了设置立即生效，前端缓存不受后台重启影响
同源的坑：离线下载 / 跨盘复制完成但目标目录没东西——先刷缓存，再查任务面板，最后核对 临时目录映射。
上传报 HTTP 413
413 = 请求体过大，是中间层拦的，不是 OpenList：
- 用了反向代理（Nginx / 宝塔）：把
client_max_body_size调大（官方示例给到 20GB），并注意超时时间同步放宽 - 没有反代仍 413：查站点是否经过 CDN 或其他网关
- 上传「成功但前端超时无响应」也是同一族问题：网关等不及先断了，加长代理超时
下载菜单突然空白
打开浏览器控制台看有没有资源被 blocked：
- 广告拦截插件（AdGuard 等）误杀了站点脚本：把站点加入白名单或临时关插件验证
- 老浏览器缺 API：换新版 Chrome / Edge / Firefox
上传提示「Uploading in the backend」
不是错误，是机制说明：所有上传都经服务器中转再进网盘，大文件会经历「浏览器传到服务器 → 服务器传到网盘」两段，表现为长时间上传中。耐心等任务完成即可，链路解释见 上传文件。