注册新用户时遇‘ReferenceError: Property 'axios' doesn't exist’错误如何解决？

算力阿峰

2026-7-1

修复 "ReferenceError: Property 'axios' doesn't exist, js engine: hermes" 错误

按以下步骤逐一排查修复：

确认axios依赖已正确安装
先检查项目中是否已安装axios，执行命令：
```
npm list axios
# yarn 用户执行
yarn list axios
```
如果输出中没有axios，立即安装：
```
npm install axios
# 或
yarn add axios
```
清除Metro缓存并重启服务
Hermes引擎下的缓存经常会导致模块加载异常，执行重置缓存命令：
```
npx react-native start --reset-cache
```
关闭当前运行的应用，重新启动项目（npx react-native run-android/run-ios）。
验证导入语句的正确性
虽然你的导入语法没问题，但可以尝试两种导入写法测试：
```
// 原写法
import axios from 'axios';
// 或尝试全量导入
import * as axios from 'axios';
```
确保没有拼写错误（比如大小写错误Axios）。
排查Hermes兼容性问题
如果上述步骤无效，可能是Hermes与当前axios版本不兼容：
1. 临时禁用Hermes测试：打开android/app/build.gradle，找到enableHermes: true改为false。
2. 清理Android项目缓存：
```
cd android && ./gradlew clean && cd ..
```
3. 重新构建应用。如果禁用后错误消失，升级axios到最新版本即可解决。
补充AsyncStorage的导入（附带修复）
你的代码中使用了AsyncStorage但未导入，React Native 0.60+需从官方包导入，否则会引发额外异常：
```
import AsyncStorage from '@react-native-async-storage/async-storage';
```