跳到主要内容

故障排除

这些是您在设置 React Native 时可能遇到的一些常见问题。如果您遇到此处未列出的问题，请尝试在 GitHub 中搜索该问题。

端口已被占用​

Metro bundler 在端口 8081 上运行。如果另一个进程已在使用该端口，您可以终止该进程，或更改 bundler 使用的端口。

终止端口 8081 上的进程​

运行以下命令以查找正在端口 8081 上监听的进程的 ID

shell
sudo lsof -i :8081

然后运行以下命令以终止该进程

shell
kill -9 <PID>

在 Windows 上，您可以使用 资源监视器 找到使用端口 8081 的进程，并使用任务管理器停止它。

使用 8081 以外的端口​

您可以配置 bundler 使用 8081 以外的端口，方法是从项目根目录运行以下命令，使用 port 参数

shell
npm start -- --port=8088

您还需要更新您的应用程序，以从新端口加载 JavaScript bundle。如果在 Xcode 中从设备运行，您可以通过在 ios/__App_Name__.xcodeproj/project.pbxproj 文件中将 8081 的出现次数更新为您选择的端口来完成此操作。

NPM 锁定错误​

如果您在使用 React Native CLI 时遇到类似 npm WARN locking Error: EACCES 的错误，请尝试运行以下命令

shell
sudo chown -R $USER ~/.npm
sudo chown -R $USER /usr/local/lib/node_modules

React 缺少库​

如果您手动将 React Native 添加到您的项目，请确保您已包含您正在使用的所有相关依赖项，例如 RCTText.xcodeproj、RCTImage.xcodeproj。接下来，这些依赖项构建的二进制文件必须链接到您的应用程序二进制文件。使用 Xcode 项目设置中的 Linked Frameworks and Binaries 部分。更详细的步骤在此处：链接库。

如果您正在使用 CocoaPods，请验证您是否已将 React 及其子规范添加到 Podfile。例如，如果您正在使用 <Text />、<Image /> 和 fetch() API，您需要在 Podfile 中添加这些内容

pod 'React', :path => '../node_modules/react-native', :subspecs => [
  'RCTText',
  'RCTImage',
  'RCTNetwork',
  'RCTWebSocket',
]

接下来，请确保您已运行 pod install 并且在您的项目中创建了安装了 React 的 Pods/ 目录。CocoaPods 将指示您今后使用生成的 .xcworkspace 文件，以便能够使用这些已安装的依赖项。

当 React Native 用作 CocoaPod 时，无法编译​

有一个名为 cocoapods-fix-react-native 的 CocoaPods 插件，它可以处理由于使用依赖管理器而导致的源代码的任何潜在的后修复。

参数列表太长：递归头文件扩展失败​

在项目的构建设置中，User Search Header Paths 和 Header Search Paths 是两个配置，用于指定 Xcode 应在代码中查找 #import 头文件的位置。对于 Pods，CocoaPods 使用特定的文件夹默认数组进行查找。验证此特定配置未被覆盖，并且配置的文件夹都不太大。如果其中一个文件夹是一个大文件夹，Xcode 将尝试递归搜索整个目录并在某个时候抛出上述错误。

要将 User Search Header Paths 和 Header Search Paths 构建设置恢复为 CocoaPods 设置的默认值 - 在“构建设置”面板中选择条目，然后按删除键。它将删除自定义覆盖并返回到 CocoaPod 默认值。

没有可用的传输​

React Native 为 WebSockets 实现了 polyfill。这些 polyfills 作为 react-native 模块的一部分进行初始化，您可以通过 import React from 'react' 将其包含在您的应用程序中。如果您加载另一个需要 WebSockets 的模块，例如 Firebase，请务必在 react-native 之后加载/require 它

import React from 'react';
import Firebase from 'firebase';

Shell Command Unresponsive Exception​

如果您遇到 ShellCommandUnresponsiveException 异常，例如

Execution failed for task ':app:installDebug'.
  com.android.builder.testing.api.DeviceException: com.android.ddmlib.ShellCommandUnresponsiveException

尝试在 android/build.gradle 中将 Gradle 版本降级到 1.2.3。

react-native init 挂起​

如果您在系统上运行 npx react-native init 时遇到挂起问题，请尝试在 verbose 模式下再次运行它，并参考 #2797 了解常见原因

shell
npx react-native init --verbose

当您调试进程或需要了解有关抛出的错误的更多信息时，您可能需要使用 verbose 选项来输出更多日志和信息，以查明您的问题。

在您的项目根目录中运行以下命令。

shell
npm run android -- --verbose

无法启动 react-native 包管理器（在 Linux 上）​

案例 1：错误 "code":"ENOSPC","errno":"ENOSPC"​

问题是由 inotify（Linux 上 watchman 使用）可以监控的目录数量引起的。要解决此问题，请在您的终端窗口中运行此命令

shell
echo fs.inotify.max_user_watches=582222 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

错误：spawnSync ./gradlew EACCES​

如果您在 macOS 上运行 npm run android 或 yarn android 时遇到抛出上述错误的问题，请尝试运行 sudo chmod +x android/gradlew 命令以使 gradlew 文件可执行。