使用Expo CLI或React Native CLI均无法npm安装@tensorflow/tfjs-react-native

报错产生原因 #

核心触发原因是旧版@tensorflow/tfjs-react-native包对React Native版本的上限限制，与你当前使用的高版本React Native/Expo不匹配，导致依赖解析失败，其他可能的触发点：

• 包管理器缓存残留，导致依赖版本解析错误
• Expo项目直接安装官方原版tfjs-react-native，未使用Expo适配的预构建版本，出现原生模块不兼容问题
• 缺少tfjs运行必需的expo-gl、react-native-fs等依赖包

对应解决方法 #

通用前置操作 #

先清除现有无效依赖和缓存，避免旧版本干扰：

# 删除依赖文件夹和锁文件
rm -rf node_modules package-lock.json yarn.lock pnpm-lock.yaml
# 清除npm缓存，用yarn/pnpm的用户替换为对应缓存清理命令即可
npm cache clean --force

Expo CLI项目专属解决方案 #

不要直接安装官方原生tfjs-react-native，使用Expo适配的版本：

npx expo install @tensorflow/tfjs @tensorflow/tfjs-react-native expo-gl

安装完成后在App入口组件添加初始化逻辑：

import * as tf from '@tensorflow/tfjs-react-native';
import { useEffect } from 'react';

export default function App() {
  useEffect(() => {
    const initTensorFlow = async () => {
      await tf.ready();
      // 初始化完成后再执行后续模型加载逻辑
    };
    initTensorFlow();
  }, []);

  // 其余App逻辑
}

React Native CLI项目专属解决方案 #

安装经过验证的兼容版本组合，避免版本不匹配：

npm install @tensorflow/tfjs@4.10.0 @tensorflow/tfjs-react-native@0.17.0 react-native-fs@2.20.0 react-native-gl@2.31.0

• iOS端额外执行原生依赖安装：

cd ios && pod install && cd ..

• 安卓端需要在android/app/build.gradle中添加配置，避免tflite模型被压缩损坏：

android {
  // 其余原有配置
  aaptOptions {
    noCompress "tflite"
  }
}

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