Expo Bundler偶发模块解析失败问题：React Native托管流程下存在文件却提示无法找到

我之前在处理Expo托管的React Native项目时，也遇到过这种「文件明明存在但打包器说找不到」的随机模块解析问题，尤其是在Windows环境下。这类问题大多和缓存失效、依赖版本不兼容或路径解析逻辑冲突有关，下面是几个经过验证的解决方案：

1. 彻底清理缓存并重新安装依赖 #

这是最常用的修复手段，能解决绝大多数缓存导致的问题：

• 首先清除Expo打包器的缓存：

  npx expo start --clear
  

• 接着清理Node的全局缓存：

  npm cache clean --force
  # 如果你用yarn的话：
  # yarn cache clean
  

• 删除本地的node_modules和锁文件（Windows环境下用对应的命令）：

  # Windows cmd
  rmdir /s /q node_modules
  del package-lock.json yarn.lock
  
  # PowerShell
  Remove-Item -Recurse -Force node_modules
  Remove-Item package-lock.json yarn.lock
  

• 最后重新安装依赖：

  npm install
  # 或 yarn install
  

2. 检查路径大小写一致性 #

Windows文件系统是大小写不敏感的，但Node的模块解析逻辑有时候会严格区分大小写。你可以：

• 确认expo-random的package.json里main字段指定的路径（./build/Random.js）和实际文件的大小写完全匹配
• 检查expo-auth-session中引用expo-random的代码路径是否大小写正确，避免出现比如写成expo-random/build/random.js（小写r）的情况

3. 对齐Expo SDK与依赖版本 #

这类随机错误经常出现在Expo SDK和各个expo-*包版本不兼容的时候。用Expo官方的命令强制安装兼容版本：

npx expo install expo-random expo-auth-session

这个命令会自动安装和你当前Expo SDK版本匹配的依赖包，避免版本不一致导致的解析问题。

4. 配置CI/CD流水线清除缓存 #

如果这个问题是在Expo托管的流水线（比如EAS Build）中出现，需要确保每次构建都清理缓存：

• 在项目根目录的eas.json中，给对应的构建配置添加cache: false：

  {
    "build": {
      "production": {
        "cache": false
      }
    }
  }
  

• 或者在流水线的前置步骤中添加清理命令，确保每次构建都从干净的依赖开始。

5. 临时应急：手动指定模块别名（不推荐长期使用） #

如果上面的方法都暂时无效，可以在metro.config.js中手动指定模块的解析路径，强制Metro找到正确的文件：

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

config.resolver.alias = {
  ...config.resolver.alias,
  'expo-random': require.resolve('expo-random/build/Random.js'),
};

module.exports = config;

为什么会出现这种随机问题？ #

这类问题的本质通常是：

• Metro打包器的缓存没有正确失效，残留了旧的模块解析记录
• Windows文件系统的大小写不敏感特性，和Node模块解析的大小写敏感逻辑产生冲突
• Expo托管环境的依赖安装缓存没有正确更新，导致部分包的文件不完整或路径映射错误

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