React Native Expo安卓应用生成Excel文件的更优方案及报错求助

嘿，我太懂你现在的抓狂了——在Expo安卓项目里用ExcelJs和Buffer生成Excel时，居然碰到栈溢出（Maximum call stack size exceeded）和类型错误，这俩报错真的能让人头大！

我来给你捋捋问题出在哪，再给你个Expo环境下更靠谱的解决方案：

为啥你用ExcelJs和Buffer会踩坑？ #

• Buffer是Node.js的核心模块，Expo的安卓JS运行环境和Node原生环境差异很大，直接用它很容易出现类型不匹配的问题，也就是你碰到的TypeError。
• 栈溢出的问题大概率是ExcelJs的某些内部递归逻辑，在Expo安卓的JS引擎里没法正常运行，导致调用栈被撑爆。

Expo安卓下生成Excel的稳妥方案：用SheetJS（xlsx）+ Expo FileSystem #

这个组合在Expo社区里用得很多，兼容性拉满，完全不需要依赖Node的Buffer模块。

第一步：安装依赖

先在项目里装需要的包：

npm install xlsx expo-file-system
# 或者用yarn的话
yarn add xlsx expo-file-system

如果之后需要让用户在系统文件管理器里快速找到生成的文件，还可以装expo-media-library来把文件加入媒体库：

npm install expo-media-library

第二步：写导出函数（替换你的export-to-excel.ts）

给你个现成的可复用代码示例，直接改改就能用：

import * as XLSX from 'xlsx';
import * as FileSystem from 'expo-file-system';
import * as MediaLibrary from 'expo-media-library';
import { Alert } from 'react-native';

export const exportToExcel = async (
  data: Record<string, any>[],
  sheetName: string = '数据表格',
  fileName: string = '导出数据.xlsx'
) => {
  try {
    // 1. 把JSON数据转成Excel工作表
    const worksheet = XLSX.utils.json_to_sheet(data);
    // 2. 创建工作簿并把工作表加进去
    const workbook = XLSX.utils.book_new();
    XLSX.utils.book_append_sheet(workbook, worksheet, sheetName);

    // 3. 生成Excel的二进制数据（用arraybuffer，完全兼容Expo）
    const excelBinary = XLSX.write(workbook, { bookType: 'xlsx', type: 'array' });

    // 4. 确定安卓的保存路径：直接存到系统下载目录
    const savePath = `${FileSystem.downloadDirectory}${fileName}`;

    // 5. 把二进制数据写入文件
    await FileSystem.writeAsBytesAsync(savePath, new Uint8Array(excelBinary));

    // 可选：把文件加入媒体库，让用户在文件管理器里快速找到
    const asset = await MediaLibrary.createAssetAsync(savePath);
    await MediaLibrary.createAlbumAsync('Download', asset, false);

    Alert.alert('导出成功', `Excel文件已保存到下载目录，文件名：${fileName}`);
  } catch (error) {
    console.error('导出Excel时出错：', error);
    Alert.alert('导出失败', '生成或保存Excel文件时出现问题，请检查数据后重试');
  }
};

第三步：调用函数

比如你有一组用户数据，直接传进去就行：

const userData = [
  { id: 1, name: '张三', age: 25 },
  { id: 2, name: '李四', age: 30 }
];

// 调用导出函数
exportToExcel(userData, '用户列表', '用户数据.xlsx');

额外小提醒 #

• 如果你的Excel需要复杂样式（比如单元格背景色、字体加粗），SheetJS的免费社区版不支持，这时候要么用SheetJS的付费Pro版，要么就放弃复杂样式优先保证兼容性——毕竟Expo环境下搞样式真的容易踩坑。
• 测试的时候尽量用Expo Go或者打包成APK测试，别在web预览里测，web和安卓的JS环境差异很大。

内容来源于stack exchange