uniCloud云存储CDN刷新无效，根本原因是未开启CDN加速且未绑定备案域名；验证需查看响应头X-Cache字段，开启后须用新cloudPath或getTempFileURL生成唯一URL，前端无法调用refreshCDNCache。
uniCloud 云存储没开 CDN 加速，刷新根本无效
很多开发者调用 uniCloud.refreshCDNCache 或在控制台点“刷新缓存”，结果页面还是旧图——第一反应是“CDN 没刷成功”，其实根本原因是：云存储压根没接入 CDN。
验证方法很简单：打开图片 URL，在浏览器 Network 面板看响应头。如果出现 X-Cache: HIT 或 X-Cache: MISS，说明已走 CDN；如果只有 Server: nginx 或类似直连标识，那就是纯源站直链。
- 必须去 uniCloud 控制台 → 对应服务空间 → 「云存储」→「CDN 加速」手动开启
- 开启后还需绑定已备案的自有域名（不能用
*.unicloud.com子域名） - 旧文件不会自动迁移到 CDN，必须重新上传或手动覆盖（用新
cloudPath）
前端不能直接触发 CDN 刷新，别白费劲写 uniCloud.refreshCDNCache
uniCloud.refreshCDNCache 只能在云函数中调用，且仅阿里云版支持；腾讯云需引入 @cloudbase/node-sdk 并配置密钥权限。uni-app 前端运行环境没有该能力，也无权访问 CDN 鉴权凭据。
所谓“前端刷新缓存”，本质是误导。你真正能做的，是让前端请求一个**从未见过的新 URL**。
- 人工刷新路径：控制台 → CDN 加速 → 输入完整 HTTPS 路径（如
https://cdn.example.com/images/avatar.jpg） - 云函数调用前提：URL 必须属于已绑定的 CDN 域名，且协议为 HTTPS
- 不要尝试在
onLoad或mounted里调用该 API——会报错undefined is not a function
真正有效的缓存破除：每次上传都生成唯一 cloudPath
CDN 缓存问题 90% 出在复用路径。比如固定用 images/avatar.png，上传新图只是覆盖，CDN 节点仍返回旧内容（因为 URL 没变、ETag 没变、缓存未过期）。
正确做法是把“更新”这件事从服务端逻辑转移到路径设计上：
- 上传时用时间戳 + 随机串拼
cloudPath：images/user/123/${Date.now()}_${Math.random().toString(36).substr(2, 8)}.png - 私有文件务必用
uniCloud.getTempFileURL({fileID})获取临时链接——每次调用都返回新 URL，天然带时效性 - 若业务强要求复用路径（如用户头像），上传后不要直接拼 URL，而是走云函数返回带时间戳参数的新地址：
https://cdn.example.com/abc.png?t=${Date.now()}
H5 端额外注意：publicPath 错了，CDN 白配
即使 CDN 域名配好了、缓存策略设对了，publicPath 一填错，所有 JS/CSS/图片请求都会打到源站或 404，CDN 根本没机会生效。
常见错误包括：publicPath: '/'（导致请求 https://your.com/static/js/app.js）、publicPath: './'（相对路径在子路由下失效）。
- 正确值应为完整 CDN 域名，末尾带斜杠：
publicPath: 'https://cdn.example.com/' - 需在
vue.config.js中显式配置，并确保 H5 平台生效：process.env.UNI_PLATFORM === 'h5' - 构建后检查
index.html中的 script 和 link 标签 href，确认是否已替换为 CDN 地址
最常被忽略的一点：CDN 缓存是否生效，和“有没有刷新”关系不大，关键在于“URL 是否真的变了”。路径复用、publicPath 错配、未开启加速这三类问题，远比刷新失败更普遍，也更容易排查。
