OpenCV.js 开发中常见问题及解决方案有哪些？

OpenCV.js 开发中最常见的问题有三个：一是 WASM 加载失败，cv 对象 undefined，原因是 opencv.js 文件约 8MB 加载慢或 CDN 不稳定，解决方案是配置多个 CDN 备用并监听 cv.onRuntimeInitialized 回调确认就绪；二是内存泄漏，浏览器长时间运行变卡，根因是 cv.Mat 通过 WASM 堆分配内存不受 JS GC 管理，必须在 try-finally 中调用 mat.delete()，视频循环中更要复用 Mat 对象而非每帧新建；三是跨域图像无法处理，canvas 被 tainted 后 cv.imread() 报错，需在 img 标签设置 crossOrigin='Anonymous' 或通过服务端代理。此外，模型文件（如 Haar Cascade XML）在浏览器端无法直接读本地路径，需 fetch 下载为 ArrayBuffer 再加载。

追问

cv.onRuntimeInitialized 和 Module.onRuntimeInitialized 有什么区别？ 前者是 OpenCV.js 的回调，后者是 Emscripten 底层回调。推荐用 cv.onRuntimeInitialized，它在 OpenCV API 完全可用时触发，而 Module 版本可能在 WASM 编译完成但 JS 绑定未就绪时就触发。

delete 一个已 delete 的 Mat 会怎样？ 会抛出异常。安全做法是 delete 后将变量设为 null，或封装一个 safeDelete(mat) 函数先判断再调用。视频循环中更好的做法是复用 Mat 而非反复创建删除。

如何排查 OpenCV.js 的内存泄漏？ 用 Chrome DevTools 的 Memory 面板做堆快照对比，关注 WASM 堆增长。也可在代码中用 cv.getBuildInformation() 确认版本，用 performance.memory（Chrome）监控 JS 堆外内存变化。

opencv.js 文件太大怎么优化加载？ 可自行编译精简版，通过 opencv_contrib 的 build_js.py 脚本用 -DBUILD_LIST 指定只编译需要的模块（如 core,imgproc），体积可从 8MB 降到 2-3MB。也可开启 WASM 流式编译（Streaming instantiation）加速。

canvas tainted 的具体报错是什么？怎么彻底避免？ 报错为 'The canvas has been tainted by cross-origin data'。根本方案：所有外部图片设 crossOrigin 属性、服务端返回正确 CORS 头、避免在 canvas 中绘制未授权跨域资源。一旦 tainted 无法逆转，只能重建 canvas。

写段代码

javascript
function onOpenCvReady() {
  let src = cv.imread('canvasInput');
  let dst = new cv.Mat();
  try {
    cv.cvtColor(src, dst, cv.COLOR_RGBA2GRAY);
    cv.imshow('canvasOutput', dst);
  } finally {
    src.delete(); dst.delete();
  }
}
cv.onRuntimeInitialized = onOpenCvReady;