xref: /expo/docs/pages/workflow/common-development-errors.mdx (revision 62adc335)

---
title: Common development errors
description: A list of common development errors that are encountered by developers using Expo.
---

This page outlines a list of errors that are commonly encountered by developers using Expo. For each error, the first bullet provides an explanation for why the error occurs and the second bullet contains debugging suggestions. If there is an error you think belongs here, we welcome and encourage you to [create a PR](https://github.com/expo/expo/pulls)!

### `expo` command not found

> **info** This applies to the [legacy `expo-cli`](/archive/expo-cli) package which is no longer used in Expo SDK 46 and greater.

- Either you do not have `expo-cli` installed or it is not properly configured in your `$PATH`.
- [Install expo-cli](/archive/expo-cli/#installation) if you have not already. Otherwise, check how to set your `$PATH` based on your OS.

### Metro bundler ECONNREFUSED 127.0.0.1:19001

- An error is preventing the connection to your local development server.
- Run `rm -rf .expo` to clear your local state. Check for firewalls or [proxies](/guides/troubleshooting-proxies) affecting the network you are currently connected to.

### Module AppRegistry is not a registered callable module (calling runApplication)

- An error in your code is preventing the JavaScript bundle from being executed on startup.
- Try running `npx expo start --no-dev --minify` to reproduce the production JS bundle locally. If possible, connect your device and access the device logs via Android Studio or Xcode. Device logs contain much more detailed stacktraces and information. Check to see if you have any changes or errors in your Babel configuration. In some rare cases, this issue could be caused by incompatibility between the Metro JavaScript minifier and certain code in your app ([more information](https://forums.expo.dev/t/change-minifierconfig-for-minify-uglify/36460/2)).

### npm ERR! No git binary found in \$PATH

- Either you do not have git installed or it is not properly configured in your `$PATH`.
- [Install git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) if you have not already. Otherwise, check how to set it in your `$PATH` based on your OS.

### XX.X.X is not a valid SDK version

- The SDK version you are running has been deprecated and is no longer supported.
- [Upgrade your project](/workflow/upgrading-expo-sdk-walkthrough) to a supported SDK version. If you are using a supported version and see this message, you'll need to update your Expo Go app.

### React Native version mismatch

- The development server running in your terminal is bundling a different version of React Native than the app in your device or simulator.
- [Align your versions of react-native](/troubleshooting/react-native-version-mismatch) by checking the versions in your **app.json** and **package.json**

### Application has not been registered

- There is a mismatch between the AppKey registered in the native and JS portion of your app.
- [Align your AppKey](../troubleshooting/application-has-not-been-registered) with the native side of your project.

### Application not behaving as expected

- It is possible caches may be preventing you from seeing the current state of your application.
- Clear all caches associated with your project in [Unix-like](../troubleshooting/clear-cache-macos-linux/) or [Windows](../troubleshooting/clear-cache-windows/) systems.