React Native安装依赖后模块解析失败（错误码500）求助

我之前开发React Native项目时也碰到过完全一样的问题！npm install后突然出现模块找不到的报错，就算删掉引用代码错误还顽固存在，大概率是缓存、依赖构建或者路径配置的锅，给你列几个亲测有效的解决办法：

1. 彻底重置Metro和依赖缓存 #

这是最常见的诱因——npm install后旧的模块解析缓存没更新，导致RN还在找已经不存在的路径。执行以下命令：

• 重置Metro开发服务器缓存：npx react-native start --reset-cache
• 清除npm本地缓存：npm cache clean --force
• 如果用Yarn的话也同步清理：yarn cache clean

2. 完全重装依赖并清理平台构建缓存 #

有时候依赖安装不完整，或者安卓/iOS的构建缓存残留了旧的模块引用：

• 删除node_modules文件夹：
  Mac/Linux：rm -rf node_modules
  Windows：rd /s /q node_modules
• 删除锁文件：rm package-lock.json yarn.lock
• 重新安装依赖：npm install
• 清理安卓构建缓存：cd android && ./gradlew clean && cd ..
• 清理iOS Pod缓存：cd ios && pod deintegrate && pod install && cd ..

3. 仔细核对文件路径的大小写（重中之重！） #

React Native在不同系统上对路径大小写的敏感度不一样：比如你代码里写的../services/MyFile，但实际文件是../services/myFile，macOS可能能正常识别，但安卓和iOS会直接报错找不到文件。一定要确保所有import的路径和实际文件的大小写完全一致。

4. 检查Metro配置文件是否正确 #

如果你的项目用了非标准的文件扩展名（比如自定义的.tsx或者.json文件），Metro可能没配置识别这些类型，导致文件被忽略。打开metro.config.js，确保resolver.sourceExts包含了你使用的所有扩展名：

const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');

const config = {};

module.exports = mergeConfig(getDefaultConfig(__dirname), {
  resolver: {
    sourceExts: ['js', 'jsx', 'ts', 'tsx', 'json'], // 按需添加你的扩展名
  },
});

5. 彻底重启开发环境 #

有时候只是服务器或模拟器没刷新干净：

• 完全关闭Metro开发服务器（不要只是后台挂着）
• 重启安卓模拟器/真机，或者iOS模拟器/真机
• 重新运行npx react-native run-android或npx react-native run-ios

6. 排查Monorepo或符号链接问题 #

如果你的项目是Monorepo结构，或者用了符号链接，Metro可能没正确解析跨包的文件路径。需要在metro.config.js里添加watchFolders配置，让Metro监听根目录下的所有文件：

const path = require('path');
const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');

const config = {};

module.exports = mergeConfig(getDefaultConfig(__dirname), {
  watchFolders: [path.resolve(__dirname, '../')], // 指向Monorepo的根目录
});

如果以上方法都试过还是不行，可以试试删除.babelrc或babel.config.js后重新生成，或者检查是否有第三方依赖和RN版本冲突的情况。

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