uni.saveImageToPhotosAlbum 报“filePath is not valid”是因为该API仅支持本地路径（如uni://、file://、tmp/开头），不接受https等网络地址；需先用uni.getImageInfo下载转为本地路径，且仅小程序可用，H5/App需条件编译降级处理。
uni.saveImageToPhotosAlbum 为什么报错“filePath is not valid”
因为这个 API 完全不接受网络地址，传入 https://xxx.jpg 会直接失败，错误信息通常是 "filePath is not valid" 或 "fail invalid file path"。它只认本地临时路径（以 uni://、file:// 或 tmp/ 开头的路径），而网络图片默认不在本地磁盘上。
常见错误现象：
- 直接把后端返回的图片 URL 塞进
uni.saveImageToPhotosAlbum({ filePath: 'https://...' })，控制台报错且无提示 - 在 H5 端调用该 API，结果静默失败（因为该接口 仅小程序支持，H5 不可用）
实操建议：
- 小程序端必须先将网络图转为本地路径，优先用
uni.getImageInfo({ src: 'https://...' })—— 它能自动下载并返回res.path - 如果
getImageInfo报 403/404，检查微信公众平台是否已配置对应域名到downloadFile合法域名列表 - 避免用
uni.downloadFile+uni.saveImageToPhotosAlbum组合：iOS 下downloadFile返回的tempFilePath有时无法被相册 API 识别，getImageInfo兼容性更稳
scope.writePhotosAlbum 权限拒绝后怎么重新申请
用户点“拒绝”一次后，uni.authorize({ scope: 'scope.writePhotosAlbum' }) 再调用就直接进 fail 回调，不会再次弹窗——这是微信的强制限制，不是 bug。
实操建议：
- 必须先调
uni.getSetting检查当前状态，而不是盲目调authorize - 若发现
res.authSetting['scope.writePhotosAlbum'] === false或undefined，就跳过authorize，直接调uni.openSetting()弹系统设置页 - 在
openSetting的 success 回调里判断res.authSetting['scope.writePhotosAlbum']是否变为true，再决定是否继续保存流程 - 别在
fail回调里反复重试授权，用户已经明确拒绝，硬刚只会增加流失
H5 和 App 端怎么兼容处理
uni.saveImageToPhotosAlbum 是纯小程序 API，在 H5 和 App（非小程序模式）下不可用。强行调用不会报错，但什么也不会发生，容易误判为“功能正常”。
实操建议：
- 用条件编译隔离逻辑：
// #ifdef MP-WEIXIN包裹小程序保存逻辑，// #ifndef MP-WEIXIN分支做降级 - H5 端可提示用户“长按图片保存”，或用
canvas+toDataURL生成 blob 链接模拟下载（但注意 iOS Safari 对download属性支持有限） - App 端（Vue 模式）推荐用
uni.downloadFile+ 原生插件或plus.gallery.save（需启用 5+ SDK），不要依赖小程序 API - 切勿在跨端逻辑里混用
getImageInfo（小程序专属）和uni.chooseImage（多端但用途不符）
图片太大或格式异常导致保存失败
iOS 对相册写入有隐式限制：超大 PNG（尤其带透明通道）、WebP、HEIC 格式可能被静默拦截，错误信息常是 "fail system error" 或直接无响应；Android 则对文件大小更敏感，超过 10MB 容易超时。
实操建议：
- 后端生成海报时，统一输出为
jpg（不带 alpha 通道），尺寸控制在 2000×3000 像素以内 - 前端拿到
getImageInfo结果后，打印res.width/res.height/res.size，大于 5MB 时主动提示“图片过大，保存可能失败” - 真机测试务必覆盖 iOS 17+ 和 Android 14，某些系统版本对 HEIC 转换逻辑不同，
getImageInfo返回的path可能仍是 HEIC 扩展名，需服务端规避
微信小程序保存图片这事，表面就一个 API，背后要卡住权限、路径、格式、多端、系统差异五根线——漏掉任何一根，用户点十次按钮都存不进去。最常被忽略的是：**你以为的“网络图片路径”，从来就不是相册 API 能认的路径**。
