Expo开发构建中react-native-background-timer报错及使用咨询

先理清核心概念（快速版） #

• 托管工作流：依赖Expo Go运行，仅支持Expo预编译的模块，无法添加第三方原生模块。
• 裸工作流：完全脱离Expo的原生项目管理，需自行维护Android Studio/Xcode配置，自由度高但繁琐。
• 开发构建（Development Builds）：Expo官方替代eject的方案，通过生成适配的原生项目模板，构建自定义的开发客户端——既能像Expo Go一样热更新JS代码，又能嵌入第三方原生模块，无需完全切换到裸工作流。

正确接入react-native-background-timer的步骤 #

1. 初始化开发构建环境 #

如果你的项目之前是纯托管模式，先安装开发构建必备依赖：

npx expo install expo-dev-client

2. 添加模块并自动配置原生依赖 #

禁止手动链接！Expo的prebuild工具会自动处理原生依赖的注册，手动操作会导致冲突：

# 安装react-native-background-timer
npm install react-native-background-timer
# 生成适配Expo的原生项目模板（--clean参数重置之前的错误配置）
npx expo prebuild --clean

3. 构建并运行自定义开发客户端 #

# 构建Android开发客户端并安装到设备/模拟器
npx expo run:android

这一步会生成包含react-native-background-timer的自定义APK，后续开发直接用这个客户端，而非Expo Go。

解决你遇到的具体错误 #

错误1：new NativeEventEmitter() was called with a non-null argument without the required addListener method #

• 执行npx expo prebuild --clean重置原生配置，确保ReactNativeBackgroundTimerPackage被自动添加到android/app/src/main/java/[你的包名]/MainApplication.java的getPackages()列表中（无需手动修改）。

错误2：TypeError: Cannot set property 'NaN' of undefined #

这是JS层调用方式不兼容导致的，按以下标准方式使用模块：

import BackgroundTimer from 'react-native-background-timer';

// 启动后台定时器示例
BackgroundTimer.start();
const timerId = BackgroundTimer.setInterval(() => {
  console.log('后台定时器触发');
}, 1000);

// 销毁定时器
BackgroundTimer.clearInterval(timerId);
BackgroundTimer.stop();

同时确保你的Expo SDK版本（建议49+）与react-native-background-timer最新稳定版（v2.4.1）兼容。

错误3：手动链接导致的重复模块错误 #

• 执行npx expo prebuild --clean覆盖手动添加的原生配置。
• 删除之前手动修改的Android文件（比如settings.gradle中添加的include ':react-native-background-timer'等内容）。

开发构建的日常使用 #

• 每次新增原生模块后，需重新执行npx expo prebuild --clean和npx expo run:android（或iOS）更新开发客户端。
• 开发时启动Metro服务：npx expo start，在自定义开发客户端中连接即可实现JS热更新，原生模块始终生效。

内容的提问来源于stack exchange，提问作者Antoine Sindhu