移动端微信Canvas白屏主因是dpr处理不当+X5内核限制+初始化时机错乱，需分四步排查：先验context是否为null；再查高清缩放逻辑；三检隐藏/切换场景下的状态；最后辨析黑底、模糊等伪白屏现象。
移动端微信浏览器中，Canvas 高清适配引发的白屏，往往不是“完全没内容”，而是画布初始化失败、context 获取为 null、或绘制后 canvas 显示为空白/黑色/模糊导致视觉上像白屏。这类问题在 iOS 和 Android 微信（X5 内核）中表现不一，但根源高度集中：设备像素比（dpr）处理不当 + X5 内核渲染限制 + 初始化时机错乱。排查需从“能否拿到 context”开始，逐层验证。
第一步：确认 canvas.getContext 是否成功返回
微信 X5（尤其旧版本 Android）在以下情况会静默返回 null，后续所有绘图调用均无效，页面无报错但留白：
- canvas 元素未正确挂载到 DOM（比如 v-if 控制显示但未触发重绘）
- canvas 宽高设为 0 或负值（常见于用 rem/rpx 计算后未转为整数，或 dpr 放大后未校验上限）
- 创建时 canvas 尺寸超过 X5 限制（Android 低端机对 >2048×2048 的 canvas 可能直接拒绝初始化）
- 使用了
crossOrigin="anonymous"但图片资源实际跨域且服务端未返回合法 CORS 头
✅ 建议加一行调试：console.log('ctx:', canvas.getContext('2d'))。若为 null，立即检查 canvas 元素是否存在、宽高是否合法、是否在隐藏状态（display: none 或父容器不可见）下初始化。
第二步：验证高清缩放逻辑是否触发异常
为适配 Retina 屏，常规做法是按 window.devicePixelRatio 放大 canvas 的 width/height 属性，并用 CSS 缩小 style.width/style.height。但微信 X5 对该流程极其敏感：
立即学习“前端免费学习笔记（深入）”；
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
- 放大倍率计算错误（如未除以
backingStorePixelRatio），导致 canvas 实际缓冲区过大，内存溢出或渲染管线崩溃 - 放大后未同步调整绘图坐标和尺寸（例如仍用 100px 绘图，实际应为 200px），造成内容被裁剪或偏移出画布
- 在 canvas 尚未完成尺寸设置时就调用
clearRect()或drawImage()，X5 可能跳过执行
✅ 快速验证：临时注释掉 dpr 缩放代码，用固定小尺寸（如 canvas.width = 300; canvas.height = 400;）测试是否恢复绘制。若恢复，说明高清逻辑是问题源。
第三步：检查隐藏/切换场景下的 canvas 状态
微信中常见白屏发生在“从后台切回前台”“页面 tab 切换后首次绘制”“弹窗关闭后渲染海报”等场景。X5 对隐藏状态下的 canvas 处理极差：
- canvas 在
display: none或父容器visibility: hidden时初始化，部分机型 context 创建失败或缓冲区未就绪 - 页面 visibility 变为 visible 后，未重新触发绘制，导致 canvas 仍为空白
- 调用
uni.canvasToTempFilePath（小程序）或toDataURL()时，canvas 实际未完成绘制（X5 异步渲染延迟高）
✅ 解决动作：确保 canvas 始终处于可见状态再初始化；监听 document.visibilityState，在变为 visible 后延时 1–2 帧再执行绘制；保存图片前加 setTimeout(() => { /* save */ }, 16) 等待渲染队列清空。
第四步：识别黑底、模糊等“伪白屏”现象
用户看到的“白屏”，有时实为黑色背景+透明内容或严重模糊无法辨识，本质是绘制流程未中断，但输出异常：
- 未主动填充白色背景：canvas 默认透明，若绘制内容全透明或含 alpha，叠加在深色 WebView 背景上即显黑（iOS 微信更明显）
- 高清缩放后未重置坐标系：未调用
ctx.scale(dpr, dpr)，导致文字/线条仍按 1x 渲染，细到不可见 - 图片资源加载完成前就开始绘制：X5 中
img.onload触发不稳定，建议用Promise.all(images.map(img => new Promise(...)))确保全部就绪
✅ 补救写法：在 ctx 获取后立即填白底：ctx.fillStyle = '#fff'; ctx.fillRect(0, 0, canvas.width, canvas.height);；绘制前统一 ctx.scale(dpr, dpr)；所有图片加载走 Promise 链控制。
