Expo iOS构建失败：本地正常但打包无法解析zillow模块

以下是针对本地运行正常但EAS构建时找不到模块问题的排查方向和解决方法：

1. 文件名大小写不匹配 #

本地macOS文件系统默认大小写不敏感，所以即使代码里写的是zillow，实际文件夹是Zillow也能正常运行，但EAS构建环境的文件系统是大小写敏感的，会直接找不到模块。

• 解决：检查../../zillow对应的实际文件夹/文件名，确保和代码中的引用完全一致（包括大小写）。

2. 模块文件未提交到Git #

EAS构建拉取的是远程Git仓库的代码，如果zillow文件夹或其入口文件（比如index.js）没被Git跟踪、未提交到远程，构建服务器上就没有这些文件。

• 解决：
  1. 执行git status查看未追踪的文件，确认zillow相关文件是否在列表中
  2. 用git add zillow/（或对应文件路径）将其加入追踪，提交并推送到远程仓库后重新构建

3. 相对路径解析差异 #

本地开发时的工作目录和EAS构建的工作目录可能存在差异，导致相对路径指向错误。

• 解决：
  1. 从ContactAgentScreen.js的实际位置出发，手动验证../../zillow的路径是否正确（比如ContactAgentScreen.js在src/screens/下，那么../../zillow应该指向项目根目录下的zillow/）
  2. 可以尝试改用绝对路径引用（需配置babel-plugin-module-resolver），比如import zillow from '@/zillow'，避免相对路径的歧义

4. Metro配置未同步到远程 #

本地修改了metro.config.js（比如添加了watchFolders、调整了resolver规则）但未提交到Git，EAS构建时使用旧的Metro配置，导致无法解析模块。

• 解决：检查metro.config.js的提交状态，确保本地的配置修改已经推送到远程，确认配置中包含了zillow所在的目录，比如：

  const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');
  const config = {};
  module.exports = mergeConfig(getDefaultConfig(__dirname), {
    watchFolders: [__dirname, '../zillow'], // 根据实际路径调整
  });
  

5. 入口文件缺失或扩展名问题 #

zillow文件夹下没有正确的入口文件（比如index.js/index.ts），或者Metro配置未包含对应的文件扩展名，导致构建时无法找到模块入口。

• 解决：
  1. 确认zillow文件夹下存在index.js（或index.ts等Metro能识别的入口文件）
  2. 检查metro.config.js的resolver.sourceExts配置，确保包含你使用的文件扩展名，比如：

  resolver: {
    sourceExts: ['js', 'jsx', 'ts', 'tsx'], // 根据项目情况添加
  }
  

额外排查步骤 #

• 用eas build --platform ios --local在本地运行EAS构建，复现问题后直接查看本地构建环境的文件结构，更容易定位路径或文件缺失问题
• 查看构建日志中显示的完整错误路径，对比本地的实际文件路径，确认是否存在路径拼接错误

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