17370845950

WebAssembly无法直接访问浏览器文件系统，必须通过JavaScript的File API读取文件并传入Wasm内存处理。

WebAssembly 本身不支持直接访问浏览器文件系统

WebAssembly（Wasm）是无权限的沙箱运行时，std::ifstream 或 fopen 在浏览器中必然失败——它没有文件系统访问能力，也不能直接读取用户选择的文件。所有文件上传必须通过 JavaScript 的 File / FileReader API 中转，再把数据传给 Wasm 模块处理。

常见错误现象：std::ifstream("test.txt") 构造成功但 .is_open() == false；或 Emscripten 编译后调用 fopen 返回 nullptr，且控制台报错 FS.abortOnCannotGrowMemory 或 no file system。

• 必须用 EMSCRIPTEN 宏判断编译目标，避免在 Wasm 环境误走原生文件路径逻辑
• Emscripten 默认不挂载虚拟文件系统（MEMFS），即使启用也只对 FS.writeFile 等 JS 主动写入的数据有效，无法自动映射用户选中的文件
• 大文件（>10MB）建议用 ArrayBuffer 直接传递二进制，避免 Base64 编码膨胀和字符串拷贝开销

用 Emscripten + JavaScript 协同完成文件上传流程

核心思路：JavaScript 负责选取、读取、校验文件；C++（Wasm）负责解析、压缩、加密等计算密集型操作；再由 JS 发起 fetch 或 XMLHttpRequest

典型步骤：

• HTML 中放
• JS 监听 change 事件，用 file.arrayBuffer() 获取原始字节
• 调用 C++ 导出函数（如 _process_upload_data），传入 arrayBuffer.byteLength 和 arrayBuffer 的内存地址（需用 Module.HEAP8.set() 拷贝）
• C++ 函数处理完后，返回结果指针与长度，JS 再封装成 Blob 或直接 fetch(..., { body: resultArrayBuffer })

注意 Emscripten 编译参数必须包含：-s EXPORTED_FUNCTIONS='["_process_upload_data"]' -s EXPORTED_RUNTIME_METHODS='["ccall","cwrap"]'，否则 JS 无法调用。

C++ 侧如何安全接收并处理 JS 传入的文件数据

不能直接把 JS 的 ArrayBuffer 地址当 C++ 指针用——Wasm 线性内存和 JS 堆内存完全隔离。正确做法是：JS 把 ArrayBuffer 数据拷贝到 Wasm 内存，C++ 从该地址开始读取。

extern "C" {
  // 假设导出函数接收：数据起始地址、长度、输出缓冲区地址、输出缓冲区最大长度
  int process_upload_data(int data_ptr, int data_len, int out_ptr, int out_max_len) {
    // 1. 从 Wasm 内存读取原始字节（Emscripten 自动映射到 Module.HEAP8）
    uint8_t* input = (uint8_t*)data_ptr;
    // 2. 处理逻辑（例如 CRC32 计算、头部解析、解密）
    uint32_t crc = 0;
    for (int i = 0; i < data_len; ++i) {
      crc ^= input[i];
      crc = (crc >> 8) ^ (0xEDB88320U & (crc << 24));
    }
    // 3. 写回结果（确保不越界）
    if (out_max_len >= 4) {
      uint8_t* out = (uint8_t*)out_ptr;
      out[0] = (crc >> 0) & 0xFF;
      out[1] = (crc >> 8) & 0xFF;
      out[2] = (crc >> 16) & 0xFF;
      out[3] = (crc >> 24) & 0xFF;
      return 4; // 实际写入字节数
    }
    return -1;
  }
}

关键点：

• 所有指针参数都是 Wasm 线性内存内的偏移量（int 类型），不是真实内存地址
• 必须检查 out_max_len，防止向 Wasm 堆外写入（会触发 abort()）
• 若需动态分配内存（如解压后变大），用 malloc() + _free()，并返回指针供 JS 读取（注意生命周期管理）

上传前绕过 CORS 或服务端限制的常见坑

即使 C++ 处理完了，JS 发起 fetch 仍可能失败。这不是 Wasm 的问题，但常被误认为“C++ 上传没生效”。

典型错误场景：

• 本地 file:// 协议打开 HTML → 浏览器拒绝 fetch（CORS preflight 不允许 file 协议）→ 必须用 http://localhost 启动静态服务
• 服务端未设置 Access-Control-Allow-Origin → 改用 nginx 反向代理或临时加响应头
• 上传字段名不匹配（如后端期待 file，JS 却传 upload）→ 检查 FormData.append("file", blob) 的第一个参数
• 未设置 Content-Type: multipart/form-data（FormData 会自动设，但手动构造 body 时容易漏）

最易忽略的一点：Emscripten 的 fetch 封装（emscripten_fetch）在现代浏览器中已被弃用，应坚持用标准 JS fetch，避免混用两种网络栈。