Angular 6导出Excel时表头报错的解决方法咨询

我之前在Angular 6项目里也遇到过类似的ExcelJS表头报错问题，大概率是版本兼容或者语法细节的问题，给你几个针对性的解决方向：

1. 优先排查ExcelJS版本兼容性 #

Angular 6属于比较早期的版本，和ExcelJS 2.x及以上版本的依赖存在冲突（比如新版依赖的Node.js版本、TypeScript版本都高于Angular 6的支持范围）。你需要降级到ExcelJS 1.x系列的稳定版本：

npm install exceljs@1.14.0 --save

如果之前安装了@types/exceljs，也要同步匹配版本：

npm install @types/exceljs@0.3.3 --save-dev

2. 检查表头配置的语法正确性 #

在ExcelJS 1.x中，表头的配置必须严格遵循格式要求，常见的错误点包括：

• 列的key值重复或与数据对象的属性名不匹配
• header不是字符串类型
• width不是数字类型

正确的表头配置示例：

// 在你的excel.service.ts中
exportExcel(data: any[], headers: any[]) {
  const workbook = new ExcelJS.Workbook();
  const worksheet = workbook.addWorksheet('导出数据');
  
  // 正确设置表头
  worksheet.columns = [
    { header: '用户ID', key: 'userId', width: 12 },
    { header: '用户名', key: 'userName', width: 20 },
    { header: '注册时间', key: 'registerTime', width: 25 }
  ];
  
  // 添加数据行（确保data中每个对象的属性名和columns的key对应）
  worksheet.addRows(data);
  
  // 后续导出逻辑...
}

3. 处理TypeScript类型报错 #

如果控制台提示类似Property 'columns' does not exist on type 'Worksheet'的类型错误，除了安装匹配的@types/exceljs外，还可以临时通过// @ts-ignore忽略单个错误（不推荐长期使用，最好还是版本匹配）：

// @ts-ignore
worksheet.columns = [
  // 表头配置
];

4. 确保异步操作正确处理 #

ExcelJS的部分导出API是异步的，如果你的表头设置后没有等待异步操作完成就执行导出，也可能导致报错。建议用async/await包裹导出逻辑：

async generateExcel() {
  const workbook = new ExcelJS.Workbook();
  const worksheet = workbook.addWorksheet('Sheet1');
  
  worksheet.columns = [/* 表头配置 */];
  worksheet.addRows(this.yourData);
  
  // 等待写入缓冲区完成
  const buffer = await workbook.xlsx.writeBuffer();
  
  // 触发下载的逻辑
  const blob = new Blob([buffer], { type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' });
  saveAs(blob, '导出数据.xlsx'); // 这里需要用到file-saver库，记得安装
}

如果以上方法还没解决，建议把控制台的具体报错信息贴出来，能更精准定位问题~

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