uni-app安卓APP离线OCR实战：从动态加载失效到文件复制的完整方案

去年接手一个物流扫描项目时，客户明确要求必须在安卓平板上实现离线条码识别。本以为用tesseract.js这类成熟库能轻松搞定，结果从开发到上线整整踩了两周坑。今天就把这套用血泪换来的解决方案完整分享出来，特别是启动时文件复制这个关键技巧，希望能帮到同样被uni-app沙盒机制折磨的同行们。

1. 技术选型与初期陷阱

当项目需求明确要求完全离线运行时，技术栈的选择就变得非常关键。我们首先排除了所有依赖云服务的OCR方案，最终锁定tesseract.js这个纯前端解决方案。选择理由很直接：

• 跨平台兼容：基于WebAssembly技术，理论支持所有能运行JS的环境
• 多语言支持：内置100+种语言训练数据
• 纯前端方案：无需原生模块集成，符合uni-app开发范式

初期验证时，web端demo确实跑得飞快。但当我们把代码移植到uni-app项目后，控制台突然报出一连串错误：

javascript复制// 典型错误示例
Uncaught ReferenceError: document is not defined 
Uncaught TypeError: URL.createObjectURL is not a function

问题根源在于tesseract.js内部使用了这些浏览器专属API：

关键提示：uni-app的renderjs虽然能模拟部分浏览器环境，但无法完全兼容所有Web API。遇到这类问题时，最好的方式是直接修改库源码或寻找替代实现。

2. 动态加载的深坑与破解之道

当我们用renderjs勉强跑通基础识别功能后，更大的坑出现了——正式包总是报"Network error"。通过Android Studio的日志排查，发现核心问题是：

tesseract.js的动态加载机制在APP环境完全失效

问题出在这个核心源码文件上：

javascript复制// tesseract.js/src/worker/browser/spawnWorker.js
if (Blob && URL && workerBlobURL) {
  const blob = new Blob([`importScripts("${workerPath}");`], {
    type: 'application/javascript'
  });
  worker = new Worker(URL.createObjectURL(blob));
} else {
  worker = new Worker(workerPath); // 安卓端走到这个分支
}

在安卓环境中，这段代码会尝试直接加载workerPath指向的文件。但实际运行时会出现：

1. 路径解析失败（APP沙盒机制导致）