structuredClone 转移 ArrayBuffer 后为什么原缓冲区失效

把 ArrayBuffer 放进 structuredClone 的 transfer 列表后，原缓冲区失效是预期行为，不是浏览器随机清空数据。转移的含义是把底层存储的使用权交给返回值，原来的 ArrayBuffer 进入 detached 状态；它的 byteLength 会变成 0，基于它的 TypedArray 视图也不能再正常读写。

普通克隆和转移克隆的内存关系

structuredClone(value) 默认复制可结构化克隆的数据。对象的结构会被递归复制，返回对象与原对象不是同一身份；对普通数组或对象的后续修改不会互相影响。这个模式适合需要保留两份数据的场景，但大块二进制内容可能带来额外复制成本。

加上 transfer 后，语义发生变化：被列出的可转移对象不再复制底层存储，而是把资源交给新对象。下面的例子故意同时保留一个旧视图，便于观察影响范围：

const source = new ArrayBuffer(8);
const view = new Uint8Array(source);
view[0] = 42;

// transfer 把底层存储交给 clone，原 buffer 会进入 detached 状态
const cloned = structuredClone({ source }, {
  transfer: [source],
});

// 后续业务应从返回对象读取，而不是继续使用旧引用
const clonedView = new Uint8Array(cloned.source);
console.log(clonedView[0]); // 42
console.log(cloned.source.byteLength); // 8
console.log(source.byteLength); // 0

这里的 source 变量并没有消失，消失的是它对底层字节存储的可用访问。cloned.source 指向同一份已转移的资源，原引用则被保留为一个不可继续使用的壳。

怎么判断失效的是缓冲区还是视图

排查时先看 byteLength，不要只看业务对象是否还存在。转移完成后，原 ArrayBuffer 的长度为 0；原 TypedArray 仍然是一个 JavaScript 引用，但它依赖的底层缓冲区已经 detached。尝试基于原 buffer 创建新视图，通常会得到 TypeError。

function inspectAfterTransfer(source, view, cloned) {
  // 0 表示原 buffer 已分离；克隆侧应保留原始字节长度
  console.log({
    sourceBytes: source.byteLength,
    oldViewBytes: view.byteLength,
    clonedBytes: cloned.source.byteLength,
  });

  try {
    // 原 buffer 已不可用于创建新的 TypedArray 视图
    new Uint8Array(source);
  } catch (error) {
    // 只记录边界错误，业务数据应改从 cloned.source 读取
    console.log(error.name); // TypeError
  }
}

inspectAfterTransfer(source, view, cloned);

可以把这组状态写进调试日志或单元测试的断言，但不要把“原 buffer 为 0”当成空文件、空报文或业务层的合法零长度数据。它表示资源所有权已经交接，排错方向应转到返回值。

转移前后怎样安排数据生命周期

最容易出错的情况是：函数把原 buffer 转移给 Worker 或另一个处理阶段后，调用方仍持有旧视图，并在稍后的异步回调里继续写入。解决办法不是在回调里反复判断，而是在接口设计上明确“调用后资源归谁”。

1. 转移前停止对原视图的写入，等待尚未完成的编码或校验。
2. 把转移操作放在所有权交接点，并立即保存返回对象。
3. 后续解析、发送和持久化都只接收克隆侧的 buffer。
4. 如果两边都必须继续修改数据，不要转移，改用默认深拷贝或显式复制字节。

还要注意异常边界：传入不能结构化克隆的值会触发 DataCloneError；这和转移成功后的 detached 状态是两类问题。前者说明输入不符合算法支持范围，后者说明资源已经按预期交给新对象。

常见问题

为什么只写 structuredClone(source) 就不会失效？

因为没有提供 transfer 列表，默认是复制。返回对象拥有自己的数据副本，原 ArrayBuffer 仍保持可用。

转移后还能恢复原 ArrayBuffer 吗？

不能通过原引用恢复。应把返回值传给下一步；如果业务还需要原数据，就必须在转移前复制一份，或根本不采用转移语义。

把 TypedArray 放进 transfer 列表可以吗？

转移列表应放可转移的底层对象，例如 typedArray.buffer。TypedArray 是视图，不是要交接的底层存储；交接后要在克隆侧重新建立视图。

判断这类问题只需记住一句话：transfer 不是“复制得更快”的开关，而是“把资源交给新对象”的所有权协议。看到原 byteLength 变成 0 时，优先检查调用方是否仍在使用旧引用，再沿着返回的克隆对象继续处理。