React Native使用expo-task-manager时出现Cannot find native module 'ExpoTaskManager'错误

安全阿岳

2026-6-25

解决ExpoTaskManager原生模块找不到的问题

确认依赖包正确安装
执行以下命令重新安装所需模块：
```
npx expo install expo-task-manager expo-background-fetch
```
重新生成Android原生项目文件
执行预构建命令，确保原生项目包含模块链接：
```
npx expo prebuild --platform android
```

检查Expo配置文件
在app.json或app.config.js中，确保plugins数组已添加对应配置：

{
  "expo": {
    "plugins": [
      "expo-task-manager",
      "expo-background-fetch"
    ]
  }
}

清理构建缓存并重新编译
依次执行以下命令：
```
cd android
./gradlew clean
cd ..
npx expo run:android
```
确认项目结构合规
由于未使用Expo Go，必须确保项目是通过expo prebuild生成的Expo管理原生项目，而非纯React Native项目直接安装Expo包。如果是纯RN项目，需先迁移到Expo原生项目结构。