真机白屏因旧接口废弃,须改用type="2d"新canvas+selectQuery获取node并按dpr缩放宽高、调用ctx.scale(dpr,dpr);网络图需先downloadFile再drawImage;朋友圈分享imageUrl须为HTTPS且无动态参数;l-painter需隐藏而非v-show且src仍需预下载。

直接用 canvas 手动绘制最可控,但必须绕开真机白屏、网络图不显示、DPR 失真、朋友圈分享失败这四个高频雷区——不是写完就跑通,而是每一步都有明确的校验点。
uni.createCanvasContext 为什么在真机上白屏
旧接口 uni.createCanvasContext('id', this) 在微信小程序基础库 2.25.0+ 已废弃,真机调用返回空 ctx,draw() 不报错但无输出。开发者工具仍兼容,导致本地正常、上线白屏。
- 必须改用
type="2d"新 canvas 节点 +createSelectorQuery获取 node -
node.width和node.height必须按设备dpr缩放(例如 iPhone 14 Pro dpr=3),否则绘制模糊或裁切 - ctx 创建后要立即调用
ctx.scale(dpr, dpr),否则文字/图片尺寸全乱
drawImage 加载网络图总留空,不报错怎么办
小程序端所有网络图片(背景、头像、二维码)必须先 uni.downloadFile 到本地临时路径,再传给 ctx.drawImage;H5 端则需确认图片响应头含 Access-Control-Allow-Origin: *,否则静默失败。
- 小程序:跳过
downloadFile直接传 URL → 白屏或空白区域 - H5:跨域失败时,
uni.getImageInfo会报错,但drawImage不报——得靠getImageInfo的 success 回调兜底 - App 端可直传 URL,但若服务器没配 CORS,同样留空;建议统一走
downloadFile兜底
onShareTimeline 的 imageUrl 怎么填才不降级
微信要求 onShareTimeline 返回的 imageUrl 必须是 HTTPS 网络地址,且不能带 token 或动态 query 参数(如 ?uid=123),否则卡片退化为纯文字链接。
- 不能把 canvas 绘制后的
tempFilePath(本地路径)直接塞进去——微信不认 - 必须调
uni.canvasToTempFilePath→uni.uploadFile上传到你自己的 CDN → 拿到 HTTPS 地址再返回 - 上传前建议加文件名哈希(如
poster_${Date.now()}.png),避免 CDN 缓存旧图
用 l-painter 插件省事,但要注意什么
l-painter 把 canvas 封装成类 HTML 标签,适合快速出图,但它隐藏了底层绘制时序和错误捕获——一旦某张图加载失败或尺寸超限,整个海报可能卡死或渲染不全。
- 组件必须用
position: absolute; left: -1000%; top: -1000%隐藏,不能用v-show或opacity: 0,否则某些安卓机型会触发无效渲染 -
l-painter-image的src若是网络图,仍需提前downloadFile,插件不自动处理 - 监听
@done回调时,务必检查res.tempFilePath是否存在,部分低端机生成失败时不进@fail而是直接返回空路径
真正难的不是画出来,而是让每张图在 iOS、Android、微信、支付宝、H5 上都稳定出现——DPR 对齐、网络图兜底、上传链路闭环,这三个点漏掉任何一个,用户长按那一刻就会失败。











