uniCloud云存储CDN缓存刷新不生效，根本原因是默认不启用CDN加速，需在控制台开启「静态资源CDN加速」并绑定备案自有域名；刷新操作必须通过控制台或云函数（阿里云支持uniCloud.refreshCDNCache，腾讯云需调用原生SDK），前端无法触发；刷新后仍显示旧内容常见于客户端强缓存未过期、URL未变更或CDN节点异步同步延迟。
uniCloud云存储CDN缓存刷新不生效？先确认是不是真在用CDN
uniCloud云存储（uniCloud.uploadFile 上传的文件）默认**不自动走CDN**，除非你主动开启「静态资源CDN加速」并完成域名绑定。很多开发者以为上传完就自动缓存、刷新就能生效，结果发现 uniCloud.getTempFileURL 返回的链接仍是直连地址（形如 https://xxx.unicloud.com/.../xxx.jpg），根本没进CDN节点——自然刷新也白刷。
验证方式：打开生成的 URL，在浏览器开发者工具 Network 面板看 Response Headers，若含 X-Cache: HIT 或 X-Cache: MISS，说明已接入 CDN；若只有 Server: nginx 或类似直连响应，则尚未启用 CDN 加速。
- 必须在 uniCloud 控制台 → 服务空间 → 「云存储」→「CDN加速」中开启，并绑定已备案的自有域名（不能用
*.unicloud.com子域名） - 绑定后，所有新上传文件会自动分配到该 CDN 域名下；旧文件仍为直链，需重新上传或手动迁移
-
uniCloud.getTempFileURL默认返回临时直链；要获取 CDN 地址，得用uniCloud.getDownloadURL（仅限已开启 CDN 的文件）或拼接你自己的 CDN 域名
CDN 缓存刷新只能通过控制台或 API，uni-app 里调不了
uni-app 运行时（前端）**没有权限触发 CDN 刷新**，这是安全限制。所谓「前端刷新缓存」实际是误导——你只能在 uni-app 里发起请求，但真正执行刷新动作的必须是服务端（云函数）或人工操作。
正确路径只有两条：
- 人工刷新：登录 uniCloud 控制台 → 对应服务空间 → 云存储 → CDN 加速 → 「刷新缓存」，支持按路径（如
/avatar/）、文件（/avatar/u123.jpg）或目录（/avatar/后带斜杠）提交刷新任务 - 云函数调用：在云函数中使用
uniCloud.refreshCDNCache（阿里云版支持，腾讯云需调用其原生 SDK），传入urls数组（必须是已绑定 CDN 域名下的完整 HTTPS 路径，如https://cdn.example.com/avatar/u123.jpg）
注意：uniCloud.refreshCDNCache 不是通用 API，只在阿里云服务空间可用；腾讯云需引入 @cloudbase/node-sdk 并调用 refreshCdnCache 方法，且需配置密钥权限。
为什么刷新后还是旧图？常见三类漏点
CDN 刷新成功 ≠ 立即生效，尤其容易卡在以下环节：
-
客户端强缓存未过期：浏览器对图片等静态资源有独立缓存策略（
Cache-Control: max-age=31536000），CDN 刷新了，但用户本地还没过期。解决方案：上传时在云存储设置「缓存时间」为短周期（如 300 秒），或上传后立即在云函数里调用uniCloud.updateFile更新cacheControl字段 - URL 未变导致不重拉：如果前端一直用同一个 URL（比如拼接了 timestamp 参数但没更新），浏览器认为是同一资源，不会发新请求。确保每次更新文件后，前端 URL 发生变化——推荐做法是上传后返回新文件 ID 或签名 URL，而非复用旧路径
- CDN 节点未全量同步：阿里云 CDN 刷新是「异步生效」，不同地域节点延迟不同（通常 5–30 分钟）。可查控制台「刷新记录」状态是否为「已完成」，别只看提交成功就认为全球已刷新
绕过 CDN 缓存的临时方案（慎用）
上线紧急修复或灰度验证时，可临时让前端跳过 CDN，直连云存储源站，但仅限调试，不可长期依赖：
- 把
uniCloud.getDownloadURL返回的 CDN 地址，手动替换成源站地址（将https://cdn.example.com换成https://xxx.unicloud.com） - 加随机查询参数强制破缓存：
url + '?t=' + Date.now()—— 这只骗过浏览器，不影响 CDN，适合单次调试 - 更稳妥的是在云函数里生成带签名的临时直链（
uniCloud.getTempFileURL），有效期可控，且不经过 CDN
真正稳定的缓存管理，核心不在「怎么刷」，而在「怎么让 URL 变」和「缓存策略配对」。CDN 是把双刃剑，用得好省流量，配不好就是脏数据温床。
