React Native+Sanity开发遇Expo模拟器报错问题求助

核心问题定位 #

你修改sanity子目录的package.json时，大概率误改了main字段或引入了与React Native/Expo不兼容的配置，导致Metro打包时混淆了根目录和子目录的入口逻辑，触发"main"未注册错误；同时Sanity部分依赖可能在Hermes引擎下存在兼容性问题。

分步解决方案 #

1. 恢复sanity子目录的package.json初始状态 #

• 不要手动修改sanity目录的package.json，Sanity初始化生成的配置是专为后端CMS设计的，和前端React Native的package.json本就不存在冲突。
• 如果没备份，直接删除sanity目录，重新执行初始化命令：

  npx sanity init
  

  选择「在现有项目中创建Sanity项目」，指定sanity作为子目录，重新生成正确的配置文件。

2. 配置Metro忽略sanity子目录 #

因为Sanity是后端服务，不需要被React Native打包，在根目录的metro.config.js中添加忽略规则：

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

const config = getDefaultConfig(__dirname);

// 让Metro跳过sanity目录的处理
config.resolver.blockList = [
  /^sanity\/.*/,
];

module.exports = config;

3. 确认前端入口文件配置正确 #

• 检查根目录package.json的main字段，确保指向正确的前端入口（通常是index.js或App.js）：

  {
    "main": "index.js"
  }
  

• 若用Expo，同步检查app.json的entryPoint配置：

  {
    "expo": {
      "entryPoint": "./index.js"
    }
  }
  

4. 修复Hermes引擎兼容性问题 #

针对TypeError: undefined is not a function报错，尝试以下操作：

• 在根目录babel.config.js中添加兼容插件：

  module.exports = function(api) {
    api.cache(true);
    return {
      presets: ['babel-preset-expo'],
      plugins: [
        '@babel/plugin-proposal-export-namespace-from',
        'react-native-reanimated/plugin',
      ],
    };
  };
  

• 若仍未解决，临时切换到JSC引擎测试：修改app.json：

  {
    "expo": {
      "jsEngine": "jsc"
    }
  }
  

5. 彻底清理缓存并重启 #

执行以下命令清除所有缓存，避免残留配置干扰：

npx expo start --clear
rm -rf node_modules && npm install
rm -rf .expo

之后重启Expo GO和Metro服务器。

验证步骤 #

1. 进入sanity目录执行npm run dev，确认CMS后端能正常启动。
2. 启动前端项目npx expo start，扫描二维码在Expo GO中打开，检查报错是否消失。

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