canvas 导出海报报 SecurityError 跨域图片不设 CORS 头怎么改

活动海报页要把商品图、二维码和标题拼成一张图给用户保存,导出走 canvas.toDataURL('image/png')。上线第二天运营反馈部分用户点了没反应,控制台一行红字:Uncaught SecurityError: Failed to execute 'toDataURL' on 'HTMLCanvasElement': Tainted canvases may not be exported. 同源的商品图没事,只有 CDN 那批图会把画布画脏。

第一反应是加载时序,图片还没 onload 就 drawImage,画上去是空白。改成等每张图的 decode() 完成再画,报错依旧。打开 Network 看响应头,CDN 那几张图没有 Access-Control-Allow-Origin,浏览器把画布标记成被污染,不允许读像素。

第一版补 img.crossOrigin = 'anonymous',结果更糟,图直接加载失败。关键在顺序:crossOrigin 必须在 src 赋值之前设,已经用不带 CORS 的方式请求过的图片会命中缓存,再改属性也不会重新发起带 Origin 的请求。调试时清一次缓存或者给 URL 补个随机参数,才看得到真实结果。

CDN 加了 Access-Control-Allow-Origin: * 之后 Chrome 120 正常,Safari 17 上还有零星失败。Safari 对缓存更固执,同一 URL 先被 img 以 no-cors 取过,后面再改 crossOrigin 依然复用旧缓存。把导出流程里所有图片统一走一个 loadImage 函数,从第一张开始就带 crossOrigin,问题消失。

用户自己上传的头像在另一个域名,也补了同样的响应头。真正绕不过的第三方外链图单独走服务端代理,前端拼一个 /proxy?u= 的地址,代理层校验域名白名单再回源,画布永远是干净的。

兜底留了一层:toDataURL 包在 try/catch 里,捕获 SecurityError 就调后端合成接口,返回图片地址。这条路径慢 400 毫秒左右。

确认口径:同源图、CDN 图、用户上传图各导出 20 次全部成功;Safari 17 上 toBlob 耗时 180 毫秒。

function loadImage(url) {
  return new Promise((resolve, reject) => {
    const img = new Image();
    img.crossOrigin = 'anonymous';
    img.onload = () => resolve(img);
    img.onerror = reject;
    img.src = url;
  });
}

您可以还会对下面的文章感兴趣: