常见开发错误

编辑

开发者在使用 Expo 时遇到的常见开发错误列表。


本页面列出了开发者在使用 Expo 时常遇到的一些错误。对于每个错误,第一个项目符号提供关于出现该错误的解释,第二个项目符号包含调试建议。如果您认为还有其他错误应当列在此处,我们欢迎并鼓励您 创建一个 PR

Metro bundler ECONNREFUSED 127.0.0.1:19001

  • 一个错误阻止了与本地开发服务器的连接。
  • 运行 rm -rf .expo 来清除您的本地状态。检查防火墙或 代理 是否影响您当前连接的网络。

模块 AppRegistry 不是一个已注册的可调用模块(调用 runApplication)

  • 您的代码中出现错误,阻止 JavaScript bundle 在启动时执行。
  • 尝试运行 npx expo start --no-dev --minify 在本地重现生产 JavaScript bundle。如果可能,请连接您的设备并通过 Android Studio 或 Xcode 访问设备日志。设备日志包含更详细的堆栈信息和信息。检查您的 Babel 配置中是否有更改或错误。在一些罕见情况下,这个问题可能是由于 Metro JavaScript 压缩器与您应用中的某些代码不兼容引起的 (更多信息)。

npm ERR! 未在 $PATH 中找到 git 二进制文件

  • 您可能没有安装 git,或者它在您的 $PATH 中未正确配置。
  • 如果您尚未安装 git,请安装它。否则,请根据您的操作系统检查如何在 $PATH 中设置它。

XX.X.X 不是有效的 SDK 版本

  • 您正在运行的 SDK 版本已被弃用且不再受支持。
  • 升级您的项目 到受支持的 SDK 版本。如果您使用的是受支持的版本且仍然看到此消息,则需要更新您的 Expo Go 应用。

React Native 版本不匹配

  • 您终端中运行的开发服务器正在打包与您设备或模拟器中的应用不同版本的 React Native。
  • 通过检查 app.jsonpackage.json 中的版本来 对齐您的 react-native 版本

应用程序未注册

  • 您的应用中原生部分和 JS 部分注册的 AppKey 不匹配。
  • 对齐您的 AppKey 与项目的原生部分。

应用程序行为与预期不符

  • 可能缓存正在阻止您看到应用程序的当前状态。
  • 清除与您的项目相关的所有缓存,具体是 Unix 类Windows 系统。