SuiteScript 2.1中SheetJS加载失败及压缩JS乱码问题求助

关于xlsx.full.min.js内容类似乱码的疑问 #

完全正常。xlsx.full.min.js是经过压缩、混淆处理的生产版本，会删除所有空格、注释，并将变量名缩短为单字符，所以视觉上看起来像乱码，只要是从SheetJS官方下载的文件，就不存在损坏问题。如果需要调试，可以下载未压缩的xlsx.full.js版本使用。

解决TypeError: Cannot read property 'read' of undefined（XLSX未加载）的步骤 #

1. 校验JsLibraryConfig.json配置 #

确保配置文件的name、path与脚本引用完全匹配：

• 示例配置（需与你的实际路径一致）：

  {
    "name": "xlsx",
    "version": "0.18.5",
    "path": "/SuiteScripts/xlsx.full.min.js"
  }
  

• 脚本中必须用@NPM/[name]的格式引用：

  import * as XLSX from '@NPM/xlsx';
  

• 确认path指向文件柜中xlsx.full.min.js的实际路径（注意区分大小写、子文件夹）。

2. 检查文件柜中的文件属性 #

• 文件类型：确保文件的类型是JavaScript File（在文件属性的“文件类型”选项中选择），不能是纯文本或其他类型。
• 部署状态：文件状态必须设为Released，不能是Inactive或Draft。
• 权限设置：给运行Suitelet的角色添加该文件的读取权限（在文件的“权限”标签页中配置）。

3. 规范SuiteScript 2.1的引用方式 #

SuiteScript 2.1仅支持ES模块的import语法，禁止使用define或全局变量方式加载：

/**
 * @NApiVersion 2.1
 * @NScriptType Suitelet
 */
import * as XLSX from '@NPM/xlsx';
import { Suitelet } from 'N/ui/serverWidget';

export const onRequest = (context) => {
  // 先测试XLSX是否加载成功
  if (typeof XLSX !== 'undefined' && XLSX.read) {
    context.response.write('XLSX库加载成功');
  } else {
    context.response.write('XLSX库未加载');
  }
};

4. 清理NetSuite缓存并重新部署 #

• 重新保存并部署Suitelet脚本，确保部署状态为Released。
• 进入NetSuite后台的Setup > Company > System Information，点击Clear Cache清除系统缓存。
• 使用浏览器隐私模式测试，避免本地缓存干扰。

5. 用未压缩版本排查 #

如果上述步骤无效，可下载未压缩的xlsx.full.js替换当前文件，修改JsLibraryConfig.json的path指向该文件后重新测试，压缩版本可能存在极端情况下的兼容性问题。

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