Node.js创建Zip文件时出现File is not defined错误的环境差异问题

• 问题根源：File属于浏览器标准API，Node.js在v20.0.0才将File类加入全局环境，Node.js 18及更早版本默认无全局File对象，这就是AKS容器（Node18）报错、Azure应用服务（Node20）正常的核心原因。

• 可行解决方案：

  • 方案1：将AKS容器的Node.js版本升级至20 LTS及以上，与Azure环境保持一致，即可直接使用全局File对象。
  • 方案2：若无法升级Node.js版本，可通过以下方式适配：
    • 利用Node.js 18支持的全局Blob模拟File对象：

      // 基于adm-zip生成的buffer创建Blob，补充File所需属性
      const zipBlob = new Blob([zipBuffer]);
      const zipFile = Object.assign(zipBlob, {
        name: 'target.zip',
        lastModified: Date.now()
      });
      

    • 或使用第三方库提供的标准File实现（如formdata-node）：
      先安装依赖：

      npm install formdata-node
      

      再在代码中引入使用：

      import { File } from 'formdata-node';
      
      const zipFile = new File([zipBuffer], 'target.zip');
      

• 跨环境兼容建议：如果代码需要同时跑在浏览器和Node.js环境，可添加环境判断适配：

  let zipFile;
  if (typeof File !== 'undefined') {
    zipFile = new File([zipBuffer], 'target.zip');
  } else {
    const { Blob } = require('node:buffer');
    zipFile = Object.assign(new Blob([zipBuffer]), { 
      name: 'target.zip', 
      lastModified: Date.now() 
    });
  }
  

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