小程序保存图片需先用uni.downloadFile下载至临时路径,H5不支持长按识别二维码,必须用原生image标签且域名合法、尺寸≥200×200px。

uni.saveImageToPhotosAlbum 在小程序里直接报错“fail no permission”
小程序端不支持直接传网络图片 URL 给 uni.saveImageToPhotosAlbum,必须先下载到临时路径。H5 端则完全不走这个流程(H5 没有相册权限概念),所以跨端时容易漏掉条件判断。
常见错误现象是:iOS 微信小程序点保存没反应,安卓真机直接报 fail no permission 或 fail invalid file path;调试器里却能成功——因为调试器模拟了权限,真机不会。
- 必须用
uni.downloadFile先拉取图片,检查downloadResult.statusCode === 200再传tempFilePath - 微信小程序要求图片域名必须在「开发管理 → 域名配置」中添加 request 合法域名,否则
downloadFile直接失败 - 支付宝小程序还需额外调用
my.authorize({scope: 'alipay.user.permission.writephotosalbum'})主动申请权限
@longpress 绑定 image 组件后长按无响应
不是所有平台都默认支持 @longpress 触发原生长按菜单。微信小程序和 App 端可以,但 H5 不支持——它只会触发一次点击,且没有系统级长按弹窗。
如果你的目标是“用户长按就唤起系统识别/保存菜单”,那只有原生渲染层能实现,image 组件在 H5 下本质是 <img> 标签,浏览器不提供该能力。
- 真机调试时优先验证微信/支付宝小程序,别依赖 H5 预览效果
- 避免给
image同时绑定@click和@longpress,部分安卓机型会误触发 click - 如需 H5 支持,得用 canvas 动态绘制图片,再监听
touchstart + touchend手动计算长按时间,成本高且体验差
长按识别二维码必须用原生渲染,不能靠前端 canvas
微信/支付宝的「识别图中二维码」功能只对原生 <image></image> 标签生效,对 canvas 导出的图片、base64 图片、甚至 view + background-image 都无效。
很多开发者想用 canvas 拼海报(头像+昵称+二维码),结果发现长按后无法识别二维码——问题不在二维码本身,而在渲染方式。
- 海报类需求务必分两层:背景用 canvas 绘制,但二维码单独用
<image src="xxx.png"></image>叠加在 canvas 上方 - 二维码图片必须是独立 HTTP(S) 地址,不能是 base64(base64 会被微信视为非可识别内容)
- 确保二维码图片尺寸 ≥ 200×200px,过小会导致识别失败率上升
uni.previewImage 的 longpressactions 在 iOS 上不显示菜单
uni.previewImage 的 longpressactions 选项仅在 App 和部分安卓小程序生效,iOS 微信小程序会忽略该配置,直接使用系统默认菜单(只有“保存图片”“发送给朋友”等固定项)。
这意味着你写 itemlist: ["保存图片", "分享"],在 iOS 上根本看不到自定义按钮,用户也无法触发你写的 saveimg() 回调。
- 不要依赖
longpressactions.success做核心保存逻辑,它不可靠 - 更稳妥的做法是:预览时隐藏系统菜单(
showmenu: false),改用右上角自定义按钮或底部操作栏提供“保存”入口 - 如果坚持用长按,必须 fallback 到
@longpress+uni.downloadFile的组合,绕过 previewImage 的限制
实际项目里最常被忽略的点是:**二维码是否以独立 <image></image> 标签形式存在**。canvas 画出来的二维码再清晰也没用,微信根本不认。这不是兼容性问题,是平台能力边界。










