绝大多数情况下无需手动刷新CDN，uniCloud云存储写即生效；仅当覆盖上传同名文件且旧缓存仍被返回时才需刷新，优先推荐换路径而非刷CDN；真要刷新须调用厂商原生API，uniCloud未封装该功能。
uniCloud云存储CDN刷新不生效？先确认是否真需要手动刷新
绝大多数情况下，你根本不需要主动调用 CDN 刷新接口——阿里云、腾讯云的 uniCloud 云存储本身是「写即生效」的：文件上传后，通过 uniCloud.getTempFileURL 或配置为公有读的 cloudPath 直接访问，CDN 节点会在首次请求时自动回源拉取并缓存。所谓“刷新”，其实是清除已有缓存，强制下次请求回源。只有当你修改了**已存在且已被 CDN 缓存的同名文件**（比如覆盖上传同一 cloudPath 的新图片），旧内容还可能被用户看到时，才需考虑刷新。
覆盖上传后 CDN 仍返回旧文件？优先换路径而非刷 CDN
这是最常被误判为“CDN没刷新”的真实问题。uniCloud 不支持同名文件覆盖后自动失效旧缓存（尤其阿里云 OSS 默认缓存策略较激进）。解决方式不是调 CDN 接口，而是从源头规避：
- 上传时避免复用
cloudPath：用时间戳、UUID 或版本号拼接路径，例如user/avatar_1234567890.jpg→user/avatar_1234567890_v2.jpg - 前端请求 URL 加随机参数（临时方案）：
https://xxx.bspapp.com/xxx.jpg?t=1718234567，绕过 CDN 缓存 - 若必须复用路径，上传前先调用
uniCloud.deleteFile删除原文件（注意：删除后旧 URL 立即 404，无过渡期）
真要调用 CDN 刷新接口？uniCloud 官方不提供，得走厂商原生 API
uniCloud SDK 没有封装 refreshCDN 这类方法。你需要自行调用云厂商的 CDN 刷新接口，且仅限对应服务商：
- 阿里云：调用
RefreshObjectCaches接口（需开通 CDN 服务并授权 RAM 子账号权限），传入文件 URL 数组，单次最多 100 条 - 腾讯云：调用
RefreshCdnUrl接口（需开通 CDN 服务），支持刷新单个 URL 或目录（目录需以/结尾） - 支付宝云：暂未开放 CDN 刷新 API，只能依赖缓存自然过期（默认 3600 秒）或改路径
注意：这些接口必须在云函数中调用（不能前端直连），且需配置对应云服务商的 SecretId/SecretKey —— 这意味着你要在云函数里硬编码密钥或从环境变量读取，安全风险需自行评估。
为什么 uniCloud.getTempFileURL 返回的链接总显示“404”？
这不是 CDN 问题，而是权限或路径错误：
- 检查文件是否真上传成功：
uniCloud.uploadFile返回的fileID是否非空，cloudPath是否含非法字符（如中文、空格） - 确认文件权限：若配置为「仅云函数可读写」，则
getTempFileURL返回的临时链接有效期默认 1 小时，过期即 404；若配置为「公有读」，则 URL 永久有效（但需确保cloudPath在控制台可见） - 阿里云特别注意：
cloudPathAsRealPath: true未启用时，所有文件实际存于cloudstorage/目录下，你传的cloudPath只是逻辑路径，真实 URL 要按控制台显示的物理路径拼接
CDN 刷新本身是个边缘操作，真正卡住多数人的，永远是路径拼错、权限配错、或误以为覆盖上传能自动更新缓存。
