Expo React Native Android开发构建后运行时出现Node标准模块'path'导入失败错误求助

兄弟，我之前在Expo 53的项目里也踩过这个一模一样的坑，简直头大！这个错误的核心问题其实是metro.config.js这个本该只在Node环境下运行的打包配置文件，被意外打包进了你的APP运行时JS bundle里，而React Native的JS引擎（Hermes）根本没有Node.js的标准库，所以找不到path模块。

先搞懂为什么会出现这种离谱的情况 #

正常来说，metro.config.js是Metro打包器的专属配置文件，只会在构建阶段（Node.js环境）被Metro读取，绝对不会被打包到APP的业务代码里。能触发这个错误的常见场景有3种：

• 业务代码里不小心引用了metro.config.js：比如复制粘贴代码时手滑，或者在某个配置文件里误写了require('./metro.config')
• Expo/Metro版本兼容性bug：你用的Expo 53 + @expo/metro-config 0.20.0是比较新的组合，可能存在版本适配问题，导致Metro误把配置文件纳入打包范围
• 缓存污染：EAS构建缓存或本地Metro缓存里残留了旧的配置，导致打包逻辑混乱

一步步解决的具体方案 #

1. 第一优先级：排查业务代码是否误引用metro.config.js #

这是最常见的原因，一定要先做：

• 用IDE的全局搜索功能，在整个项目里搜索metro.config，看看有没有在.js/.ts/.tsx文件里出现import或require语句
• 重点检查app/_layout.js、babel.config.js、plugins目录下的自定义插件，这些地方最容易不小心写错引用

2. 调整Metro配置，强制排除自身被打包 #

如果没找到误引用，那就在metro.config.js里手动把自己加入Metro的排除列表，确保它不会被打包进bundle：
修改你的metro.config.js为：

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

const config = getDefaultConfig(__dirname);

// 强制排除metro.config.js被打包进APP运行时
config.resolver.blockList = [
  ...(config.resolver.blockList || []),
  // 匹配当前目录下的metro.config.js
  new RegExp(path.resolve(__dirname, 'metro.config.js')),
];

module.exports = config;

这里用path.resolve生成绝对路径的正则，能精准匹配当前项目的配置文件，避免误排除其他目录下的同名文件。

3. 彻底清除所有缓存，从干净状态重新构建 #

缓存是很多Expo构建问题的罪魁祸首，一定要清干净：

• 本地缓存：在项目根目录运行npx expo start --clear，清除Metro的本地缓存
• EAS构建缓存：下次构建时加上--clear-cache参数，命令改成：

  eas build --profile development --platform android --clear-cache
  

4. 修复版本兼容性问题 #

你用的依赖版本组合里，@expo/metro-config 0.20.0和Expo 53.0.19可能存在小版本适配问题，可以尝试：

• 把@expo/metro-config升级到最新的0.20.x版本：

  npm install @expo/metro-config@~0.20.5
  

• 同时把Expo升级到53的最新小版本：

  npm install expo@~53.0.20
  

• 升级完成后，运行npx expo prebuild --clean重新生成原生配置文件，再重新构建。

5. 最后一招：回退到更稳定的版本组合 #

如果上面的方法都不行，那可能是React 19 + Expo 53的全新组合存在未修复的bug，可以暂时回退到更稳定的版本：

• 把React降级到18.2.0，React Native降级到0.78.10，Expo降级到52，这个组合经过大量开发者验证，稳定性很高。

最后再提醒一下 #

这个错误的本质是“本该在构建阶段运行的Node环境代码，跑到了没有Node标准库的React Native运行时”，所以所有解决方案都是围绕“让metro.config.js只在构建阶段执行，绝对不进入APP bundle”来的。

内容来源于stack exchange