Expo React Native使用google-spreadsheet报child_process模块无法解析错误

问题根因 #

child_process是Node.js服务端的内置模块，React Native/Expo的移动端运行环境没有提供该原生模块。你在浏览器端运行正常，是因为google-auth-library会自动识别浏览器环境，跳过依赖child_process的服务端身份验证分支，但打包移动端应用时，Metro打包器会扫描全量依赖，检测到缺失模块就直接抛出报错。
google-spreadsheet本身就是为Node.js服务端场景封装的库，默认没有做React Native环境的适配，这是报错的核心原因。

可行解决方案 #

方案1（优先推荐）：直接调用Google Sheets REST API #

不需要引入任何第三方依赖，完全规避Node原生模块缺失问题：

• 首先在Google Cloud Console开启Google Sheets API，根据你的使用场景申请凭证：
  • 仅读取公开表格：申请API密钥即可
  • 需要修改表格/读取非公开表格：配置OAuth 2.0客户端ID，配合Expo的AuthSession模块完成移动端身份验证
• 直接通过fetch调用官方REST接口完成读写操作，示例读请求：

const SHEET_ID = '你的表格ID';
const API_KEY = '你的API密钥';
const RANGE = 'Sheet1!A:Z'; // 读取范围

fetch(`https://sheets.googleapis.com/v4/spreadsheets/${SHEET_ID}/values/${RANGE}?key=${API_KEY}`)
  .then(res => res.json())
  .then(data => console.log('表格数据：', data))

方案2（临时兼容）：Mock缺失的Node原生模块 #

如果你非要保留google-spreadsheet依赖，可以通过Metro配置映射缺失的模块：

1. 安装所需的mock依赖：

npm install react-native-childprocess crypto-browserify stream-browserify

2. 在项目根目录创建/编辑metro.config.js，添加如下配置：

const { getDefaultConfig } = require('expo/metro-config');

const config = getDefaultConfig(__dirname);

config.resolver.extraNodeModules = {
  ...config.resolver.extraNodeModules,
  'child_process': require.resolve('react-native-childprocess'),
  'crypto': require.resolve('crypto-browserify'),
  'stream': require.resolve('stream-browserify'),
  // 后续如果出现其他Node原生模块报错，也在这里添加对应mock映射，不需要的模块可以设为false
  'fs': false,
  'net': false,
  'tls': false
};

module.exports = config;

注意：该方案仅能解决打包阶段的报错，运行阶段可能因为mock模块和原生模块逻辑不一致出现其他问题，不建议长期使用。

方案3（安全性最高）：迁移表格交互逻辑到后端 #

把所有和Google Sheets的读写逻辑放在自己的后端服务实现，移动端仅调用后端接口，既不会出现模块缺失问题，也避免了把谷歌服务账号密钥、API密钥等敏感信息打包到客户端被反编译泄露的风险。

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