uniapp 保存图片在安卓和苹果平台都生效，在鸿蒙平台不生效，排查方案

在 uni-app 开发中，保存图片在 Android 和 iOS 生效但在鸿蒙平台不生效，通常由以下几个原因导致，请按以下方面排查：

1. 条件编译标识问题（最常见原因）

   • 如果保存图片的代码使用了 // #ifdef APP-PLUS 进行条件编译，该标识仅对 Android 和 iOS 生效，不会命中鸿蒙平台。
   • 鸿蒙应用的条件编译标识为 APP-HARMONY，或者全端 App 通用的 APP。
   • 详情可参考条件编译说明：uni-app 开发鸿蒙应用条件编译。

2. 调用了底层 5+（plus.gallery）API

   • Android 和 iOS 常有开发者使用 plus.gallery.save(...) 保存图片，但鸿蒙平台上并不完全通用 Android/iOS 的 5+ runtime API。
   • 建议统一使用 uni-app 标准 API：uni.saveImageToPhotosAlbum。

3. 图片路径格式问题（网络路径未先下载）

   • uni.saveImageToPhotosAlbum 的 filePath 参数要求为本地临时路径或本地持久化文件路径。
   • 部分平台对直接传入网络 URL 存在容错，但在鸿蒙端直接传入网络 URL 会导致保存失败。
   • 正确流程：先调用 uni.downloadFile 将网络图片下载到本地临时路径，在成功回调中获取 res.tempFilePath，再传入 uni.saveImageToPhotosAlbum 进行保存。

4. 相册访问权限问题

   • 鸿蒙系统拥有严格的用户隐私与权限控制机制，如果未授予相册/媒体存储权限，保存接口会直接进入 fail 回调。
   • 建议在 uni.saveImageToPhotosAlbum 的 fail 回调中打印具体的 err 错误信息以确认是否为权限拒绝。

5. API / 预览组件缺陷排查

   • 如果是通过 uni.previewImage 预览内置的保存功能，请确保 HBuilderX 处于较新版本，旧版本曾存在切换图片保存失败的问题，官方已在后续版本中进行修复（详情可参考：更新日志）。

推荐的标准保存图片代码示例：

javascript复制代码

1. // 1. 如果是网络图片，先下载到本地临时路径
2. uni.downloadFile({
3. url: 'https://example.com/image.png',
4. success: (res) => {
5. if (res.statusCode === 200) {
6. // 2. 调用标准 API 保存到相册
7. uni.saveImageToPhotosAlbum({
8. filePath: res.tempFilePath,
9. success: () => {
10. uni.showToast({ title: '保存成功', icon: 'success' });
11. },
12. fail: (err) => {
13. console.error('保存相册失败：', err);
14. uni.showToast({ title: '保存失败', icon: 'none' });
15. }
16. });
17. }
18. },
19. fail: (err) => {
20. console.error('下载图片失败：', err);
21. }
22. });