先给个核心结论：iOS 真机上 Canvas 的高度一旦超过 4096px，就会静默失败——不报错、不回调，画布内容直接变空。这不是你代码写错了，而是微信小程序在 iOS 平台上的硬性限制。解决办法也很明确：分段绘制，每段控制在 3800px 以内，并且一定要在 draw 的回调函数里调用 canvasToTempFilePath。
canvas绘制超大图在iOS真机报“canvas is empty”或直接空白
根本原因其实很简单：iOS 微信小程序对 Canvas 单次渲染高度有硬限——超过 4096px 就塌了。不是代码逻辑错误，而是平台能力的边界。不管你用的是 painter 插件、echarts 还是手写 Canvas，只要最终生成的画布高度 > 4096px，iOS 真机必然失效。
实操建议拆开来讲：
- 先用
uni.getImageInfo拿到原图宽高，预估绘制后的画布尺寸（尤其注意文字行高、留白叠加后的总高度）。 - 如果预估高度达到 4000px 以上，必须分段绘制：把内容拆成多个
，每段控制在 3800px 以内，再用canvas.toTempFilePath逐段导出，最后用服务端拼接或前端drawImage合成。 - 别想着用
scale(0.5)来绕过限制——缩放后仍然按原始像素计算高度，4096 上限照常触发。 - 安卓和开发者工具上没这个限制，所以务必在真机上测试，千万别信模拟器。
canvasToTempFilePath报“fail canvas is empty”但draw已调用
出现这个报错，十有八九是异步资源还没就绪就急着导出。比如图片的 onload 没等完、字体 loadFont 还在加载、或者 Vue 响应式数据变更还没渲染到 DOM。微信小程序里 ctx.draw() 只是提交绘制指令，并不保证立刻完成。
操作要点：
- 所有图片必须走
uni.getImageInfo→ctx.drawImage的流程，不能直接用img.src赋值后就 draw。 ctx.draw(false, callback)里的callback才是绘制真正结束的信号，canvasToTempFilePath必须放在这个回调里面，而不是 draw 调用后立刻执行。- 涉及文字渲染时，用
ctx.setFontSize后加await new Promise(r => setTimeout(r, 16))防止字体未加载完成（iOS 特别敏感）。 - H5 端不支持
canvasToTempFilePath，必须用conditionCompile隔离逻辑，否则编译能通过但运行时会报错。
canvas绘制网络图时H5端报“tainted canvases may not be exported”
这是浏览器 CORS 策略导致的污染问题。H5 端用 drawImage 加载跨域图片后，toDataURL 会被拒绝；而小程序和 App 端因为沙箱机制不同，反而能正常导出。现象就是开发时一切正常，一上线 H5 就崩溃。
实际处理方案：
- 所有网络图片 URL 必须带上
crossOrigin="anonymous"属性，并且服务端需要返回Access-Control-Allow-Origin: *（不能带credentials）。 - 如果服务端配置改不了，改用
fetch+createObjectURL中转：fetch(imgUrl).then(res => res.blob()).then(blob => URL.createObjectURL(blob))，再把 URL 喂给new Image()。 - 避免在
drawImage后立即调toDataURL，加setTimeout(() => {}, 0)让事件循环跑完，不然部分浏览器会判定为“未完全污染清除”。 - 微信内置浏览器（iOS Safari 内核）对此最严格，必须实机验证。
canvasId传参正确却报“should pass canvasId or canvas”
这个错误不是参数写错了，而是 组件还没挂载到页面 DOM 树里，uni.createCanvasContext 拿不到有效上下文。常见场景包括条件渲染（v-if）、路由懒加载、或者在 onReady 没等完就初始化 Canvas。
规避方法：
标签必须有id和canvas-id两个属性，且值一致，例如id="shareCanvas"+canvas-id="shareCanvas"。- 初始化 context 前，用
uni.createSelectorQuery().in(this).select('#shareCanvas').fields({ node: true })查节点是否存在，exec回调里再创建 context。 - Vue3 组合式 API 中，不要在
setup里直接uni.createCanvasContext，应该放在onMounted或nextTick之后。 - 真机调试时，
console.log输出ctx对象，如果为null或undefined，说明 DOM 未就绪，不是 API 调用问题。
总结一下几个关键点：iOS Canvas 高度限制是硬伤，没法绕过；H5 跨域污染是浏览器行为，需要服务端配合才能根治；而“canvas is empty”和“should pass canvasId”本质都是时机问题——不是 API 不会用，是没等到它真正准备好。
