Node 20.19.4环境下React Native Metro报错os.availableParallelism is not a function的原因、无手动Polyfill修复方案及配置咨询

嘿，我来帮你搞定这个头疼的Metro报错问题！从报错原因到不用手动加Polyfill的修复方法，再到如何确保Metro用对Node原生的os模块，我都给你理得明明白白。

一、为啥会报这个错？ #

结合你用的Node 20.19.4和Metro 0.80.0版本，核心问题大概率是依赖优先级冲突：

1. 先补个基础：os.availableParallelism是Node.js 19.4.0才新增的API，Metro 0.80.0本身是支持Node 18+的，内部已经做了兼容处理——按道理不该报错。
2. 那问题出在哪？很大可能是你的项目里某个依赖（比如旧版工具库、或者浏览器端的polyfill包）偷偷覆盖了Node.js的内置os模块，导致Metro加载的不是原生的os模块，而是一个没实现availableParallelism方法的阉割版polyfill。
3. 当然也不排除你之前的依赖残留没清干净，导致Metro的某个子依赖还是用了不兼容的版本。

二、不用手动加Polyfill的修复方案 #

你已经做了不少清理步骤，我给你优化下，确保彻底解决问题：

1. 彻底清干净所有残留（比你之前的步骤更彻底） #

先把所有可能搞事情的缓存、残留文件全删光：

# 删项目依赖、iOS相关缓存
rm -rf node_modules ios/Pods ios/build ios/Podfile.lock ~/Library/Developer/Xcode/DerivedData ~/.metro yarn.lock
# 删Yarn本地缓存（之前可能漏了这个）
rm -rf ~/.yarn/cache
# 强制清Yarn缓存
yarn cache clean --force

2. 先锁死兼容的Metro版本，再安装 #

别先装Metro再跑yarn install，这样容易被其他依赖带偏版本。直接手动改package.json的devDependencies，把兼容的版本锁死：

"devDependencies": {
  // 其他依赖不动，加下面两行
  "metro": "^0.80.0",
  "@react-native/metro-config": "^0.80.0"
}

改完后直接跑：

yarn install

这样Yarn会严格按照你指定的版本安装Metro，不会乱拉其他版本。

3. 重新配置iOS依赖并启动 #

接着按正常流程配置iOS并启动项目：

cd ios && pod install && cd ..
yarn ios

4. 额外排查：有没有第三方os包在搞事情？ #

如果还是报错，去检查下你的项目里是不是装了os-browserify这类浏览器端的polyfill包——这类包会直接覆盖Node的原生os模块，要是有，直接卸载：

yarn remove os-browserify

另外，你可以在项目根目录跑个小命令验证Node原生os模块是否正常：

node -e "console.log(require('os').availableParallelism())"

要是能正常输出你的CPU核心数，说明Node本身没问题；要是报错，那你得重新装一遍Node 20.19.4了。

三、如何配置Metro确保用对Node原生os模块？ #

要从根源上避免Metro加载错os模块，直接在metro.config.js里加个配置，强制Metro用Node原生的os模块：

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

const customConfig = {};
const defaultConfig = getDefaultConfig(__dirname);

// 关键配置：强制Metro加载Node原生的os模块，跳过node_modules里的第三方os包
defaultConfig.resolver.extraNodeModules = {
  ...defaultConfig.resolver.extraNodeModules,
  os: require.resolve('os'),
};

module.exports = mergeConfig(defaultConfig, customConfig);

这个配置的意思是，当Metro需要加载os模块时，直接用Node内置的版本，不会去node_modules里找第三方的polyfill包，从根源上杜绝覆盖问题。

最后再啰嗦两句 #

要是按上面的步骤还搞不定，去翻下你的yarn.lock文件，搜索os关键词，看看有没有第三方的os包被安装，找到引入它的依赖，要么升级那个依赖，要么用yarn的resolutions字段强制排除它。

内容来源于stack exchange