引入expo-server-sdk时出现zlib模块解析错误求助

核心原因 #

expo-server-sdk是服务端专用库，依赖Node.js原生的zlib模块，而Expo客户端环境（iOS/Android/web）不支持这类Node.js核心模块，直接在客户端代码里引入必然会报错。

解决方案 #

• 迁移到服务端：把需要用到expo-server-sdk的逻辑（比如发送推送通知、管理Expo资源）移到Node.js后端服务中，客户端通过API请求调用后端接口完成操作。客户端如果需要处理推送相关功能，应该使用expo-notifications这类客户端库。

• 清理依赖并重置缓存：

  1. 删除依赖目录和锁定文件：

     rm -rf node_modules package-lock.json yarn.lock
     

  2. 重新安装依赖：

     npm install
     # 或 yarn install
     

  3. 清除Expo缓存并重启项目：

     npx expo start -c
     

• 调整Metro配置临时规避（不推荐长期使用）：
  如果暂时需要调试，可在metro.config.js中添加规则排除zlib模块：

  const { getDefaultConfig } = require('expo/metro-config');
  const config = getDefaultConfig(__dirname);
  
  config.resolver.blacklistRE = /node_modules\/zlib\/.*/;
  
  module.exports = config;
  

• 检查版本兼容性：
  确保expo-server-sdk版本与你使用的Expo SDK版本匹配，安装对应版本：

  npm install expo-server-sdk@<匹配的版本号>
  

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