Expo React Native中TensorFlow COCO-SSD报gl.texStorage2D未定义错误求助

问题背景 #

Expo构建的React Native应用，使用TensorFlow.js和COCO-SSD进行目标检测时，Android模拟器及官方示例项目触发以下错误：

TypeError: gl.texStorage2D is not a function. (In 'gl.texStorage2D(tex2d, 1, internalFormat, width, height)', 'gl.texStorage2D' is undefined)

图片编解码流程日志正常，错误仅在模型检测阶段触发；该功能在iPhone 13 Max真机上可正常运行，已安装expo-gl、expo-gl-cpp等依赖。

可能原因 #

1. WebGL版本差异：gl.texStorage2D是WebGL 2.0专属API，Android模拟器默认可能仅启用WebGL 1.0，而iOS真机原生支持WebGL 2.0，导致API缺失。
2. 依赖版本不兼容：当前@tensorflow/tfjs-react-native@0.8.0与expo-gl@~12.0.1的版本组合存在适配问题，TensorFlow.js的WebGL后端无法正确调用Expo提供的GL上下文。
3. 模拟器GPU配置不足：Android模拟器未启用硬件加速，导致WebGL特性支持不全。

解决步骤 #

1. 强制Android模拟器启用WebGL 2.0 #

• 打开模拟器的设置 > 系统 > 开发者选项，找到WebGL渲染模式，设置为WebGL 2.0。
• 重启模拟器后重新测试。

2. 调整依赖版本至兼容组合 #

替换当前依赖为经过验证的版本：

{
  "expo-gl": "~13.0.1",
  "expo-gl-cpp": "~13.0.1",
  "@tensorflow/tfjs": "4.8.0",
  "@tensorflow/tfjs-react-native": "0.9.0",
  "@tensorflow-models/coco-ssd": "^2.2.2",
  "@react-native-async-storage/async-storage": "~1.17.3",
  "react-native-fs": "^2.20.0",
  "expo-file-system": "~15.1.1"
}

• 执行npm install或yarn install更新依赖，清除Expo缓存（expo r -c）后重新启动项目。

3. 优化TensorFlow.js初始化与图片解码流程 #

确保TensorFlow.js正确绑定Expo GL上下文，使用@tensorflow/tfjs-react-native提供的解码方法：

import * as tf from '@tensorflow/tfjs';
import { decodeJpeg } from '@tensorflow/tfjs-react-native';
import * as FileSystem from 'expo-file-system';
import * as cocossd from '@tensorflow-models/coco-ssd';

// 提前初始化TensorFlow.js，确保GL上下文就绪
await tf.ready();

const file = `${FileSystem.documentDirectory}image-new-${imageIndex}.jpg`;
const imgB64 = await FileSystem.readAsStringAsync(file, {
  encoding: FileSystem.EncodingType.Base64,
});

tf.engine().startScope();
try {
  // 使用tfjs-react-native的decodeJpeg，确保使用Expo提供的GL上下文
  const imageBuffer = tf.util.encodeString(imgB64, 'base64');
  const tensor = await decodeJpeg(imageBuffer);
  
  const model = await cocossd.load();
  const predictions = await model.detect(tensor);
  console.log('Prediction found:', predictions);
} finally {
  // 释放资源
  tf.engine().endScope();
}

• 关键：避免直接使用TFJS核心库的decodeJpeg，改用@tensorflow/tfjs-react-native的方法，确保TensorFlow使用正确的GL上下文。

4. 启用模拟器硬件加速 #

• 打开Android Studio的AVD Manager，选择目标模拟器点击Edit。
• 在Emulated Performance区域，将Graphics设置为Hardware - GLES 2.0或更高版本。
• 保存配置后重启模拟器。

额外排查建议 #

• 测试Android真机是否存在同样问题，若真机正常则说明仅模拟器环境存在限制。
• 检查项目中是否有其他依赖覆盖或冲突expo-gl的版本。

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