故障排除
这些是你在设置 React Native 时可能遇到的一些常见问题。如果你遇到此处未列出的问题,请尝试在 GitHub 中搜索该问题。
端口已被占用
Metro 打包器在端口 8081 上运行。如果另一个进程已经在使用该端口,你可以终止该进程,或更改打包器使用的端口。
终止端口 8081 上的进程
运行以下命令以查找正在监听端口 8081 的进程 ID
sudo lsof -i :8081
然后运行以下命令终止进程
kill -9 <PID>
在 Windows 上,你可以使用资源监视器找到使用端口 8081 的进程,并使用任务管理器停止它。
使用 8081 以外的端口
你可以通过使用 port
参数来配置打包器使用 8081 以外的端口,从项目根目录运行
- npm
- Yarn
npm start -- --port=8088
yarn start --port 8088
你还需要更新你的应用程序,以便从新端口加载 JavaScript 包。如果从 Xcode 在设备上运行,你可以通过在 ios/__App_Name__.xcodeproj/project.pbxproj
文件中将所有出现的 8081
更新为你选择的端口来完成此操作。
NPM 锁定错误
如果你在使用 React Native CLI 时遇到诸如 npm WARN locking Error: EACCES
的错误,请尝试运行以下命令
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
并且在你的项目中已创建 Pods/
目录并安装了 React。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作为你通过 import React from 'react'
包含在应用程序中的 react-native 模块的一部分进行初始化。如果你加载了需要 WebSockets 的其他模块,例如 Firebase,请务必在 react-native 之后加载/引入它
import React from 'react';
import Firebase from 'firebase';
Shell 命令无响应异常
如果你遇到诸如以下 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
出现挂起问题,请尝试在详细模式下再次运行它,并参考 #2797 了解常见原因
npx react-native init --verbose
当你调试进程或需要更多关于抛出错误的信息时,你可能希望使用详细模式选项来输出更多日志和信息,以确定你的问题。
在项目根目录中运行以下命令。
- npm
- Yarn
npm run android -- --verbose
yarn android --verbose
无法启动 react-native 包管理器(在 Linux 上)
情况 1:错误 "code":"ENOSPC","errno":"ENOSPC"
问题是由于 inotify(由 Linux 上的 watchman 使用)可监视的目录数量过多引起的。要解决此问题,请在终端窗口中运行此命令
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
文件可执行。