Node.js中如何通过文件绝对路径创建符合原生Blob校验的File对象

结论 #

完全可以实现你需要的通过绝对路径创建符合要求的File对象的能力，不过Node.js没有原生提供File.fromAbsPath这类静态方法，需要自行基于Node.js文件API和符合Web规范的Blob/File实现封装。

核心前提说明 #

你之前自行模拟File接口过不了校验的原因很明确：目标库的校验逻辑要求实例必须是规范Blob类的实例，自定义的模拟类无法通过instanceof Blob校验，所以必须使用符合Web API规范的Blob/File实现。

同时处理8GB以上大文件的核心要求是不能一次性将全量文件读入内存构造Blob，必须使用流式实现，仅在读取对应文件片段时才从磁盘加载数据，和浏览器文件选择器返回的File行为完全一致。

具体实现方案 #

Node.js v19.2.0及以上版本已经全局内置了符合Web规范的File和Blob类，低版本可以安装undici包获取兼容实现，不会有兼容性问题。

1. 依赖安装（仅Node.js <19需要） #

npm install undici

2. 工具方法封装 #

const { open } = require('fs/promises');
// 优先用全局自带的File，低版本从undici引入
const { File } = globalThis.File ? globalThis : require('undici');

/**
 * 从绝对路径创建符合Web规范的File对象
 * @param {string} filePath 文件绝对路径
 * @param {Object} options 可选配置：filename指定文件名、type指定MIME类型
 * @returns {Promise<File>} 符合规范的File实例，可通过instanceof Blob校验
 */
async function fileFromAbsPath(filePath, options = {}) {
  const fileHandle = await open(filePath, 'r');
  const stat = await fileHandle.stat();
  // 创建文件可读流，不会预加载全量文件内容
  const fileStream = fileHandle.createReadStream();

  // 构造File实例
  const file = new File(
    [fileStream],
    options.filename || filePath.split(/[\\/]/).pop(),
    {
      type: options.type || 'application/octet-stream',
      lastModified: stat.mtimeMs
    }
  );

  // 补全size属性（部分流式构造场景不会自动填充正确值）
  Object.defineProperty(file, 'size', {
    value: stat.size,
    writable: false,
    configurable: false,
    enumerable: true
  });

  return file;
}

3. 使用示例 #

// 调用方式和你期望的File.fromAbsPath基本一致
const file = await fileFromAbsPath('/your/large/file/path.iso');

// 校验可正常通过
console.log(file instanceof Blob); // 输出 true

注意事项 #

• 该实现全程流式处理，不会将全量文件加载进内存，10GB以上的超大文件也可以正常处理，只要你的传输库是按分片读取Blob内容（你提到库本身支持大文件，说明已经满足这个条件）。
• 不要自行对返回的File实例调用arrayBuffer()方法，否则还是会尝试加载全量文件内容导致内存溢出，正常使用传输库的方法即可。

内容的提问来源于stack exchange，提问作者HelloWorld