React Native Paper 项目中 NativeModule.getConstants 报错分析与解决

在 React Native 开发过程中，升级到 React Native 0.76.2 和 Expo 52 后，很多开发者会遇到一个典型的错误："TypeError: NativeModule.getConstants is not a function"。这个错误通常会在运行测试时出现，特别是在使用 React Native Paper 组件库时。

错误现象分析

当开发者执行测试时，控制台会抛出上述错误，并伴随一个完整的调用堆栈。从堆栈信息可以看出，问题起源于 React Native 的 NativeDeviceInfo 模块，随后影响到 Dimensions 工具类，最终导致 StyleSheet 相关功能无法正常工作。

根本原因

这个问题的核心在于测试环境中缺少对 React Native 原生模块的适当模拟。具体来说：

1. React Native 的测试环境需要模拟原生模块的行为
2. 在 React Native 0.76.2 中，DeviceInfo 模块的模拟方式发生了变化
3. 测试环境没有正确初始化这些模拟模块

解决方案

要解决这个问题，开发者需要确保测试环境正确配置了所有必要的模拟模块。以下是几种可行的解决方案：

方案一：检查 Jest 配置

确保你的 jest.config.js 或 package.json 中的 jest 配置包含了 React Native 的预设：

{
  "preset": "react-native"
}

方案二：手动添加模拟

在测试文件或测试配置中添加对 DeviceInfo 模块的模拟：

jest.mock('react-native/Libraries/Utilities/NativeDeviceInfo', () => ({
  getConstants: () => ({
    // 返回你需要的常量
  })
}));

方案三：检查第三方库的模拟

某些第三方库（如 react-native-mmkv-storage）可能会覆盖全局的模拟设置。可以尝试：

1. 检查是否有第三方库修改了全局的 __fbBatchedBridgeConfig 或 __turboModuleProxy
2. 必要时临时注释掉这些修改以测试是否是它们导致的问题

最佳实践

为了避免这类问题，建议开发者在升级 React Native 版本时：

1. 仔细阅读官方升级指南中的测试相关变更
2. 保持测试环境的模拟与生产环境一致
3. 定期更新测试相关的依赖项
4. 在 CI/CD 流程中加入测试环节，尽早发现问题

总结

NativeModule.getConstants 报错是 React Native 测试环境中常见的问题，特别是在版本升级后。通过正确配置测试环境和模拟模块，开发者可以轻松解决这个问题，确保测试流程的顺畅运行。理解 React Native 测试环境的工作原理对于预防和解决这类问题至关重要。