Node 19环境下安装Realm时进程卡住的问题求助

• 检查Node.js与包管理器版本兼容性
  Realm对Node.js版本有明确要求，多数稳定版本需要Node.js 16.x及以上。执行以下命令确认版本：

  node -v
  npm -v # 或 yarn -v
  

  若版本过低，升级至对应LTS版本后重试安装。

• 清理包管理器缓存与冗余文件

  1. 执行缓存清理命令：
     • npm：npm cache clean --force
     • yarn：yarn cache clean
  2. 删除项目根目录下的node_modules文件夹、package-lock.json（npm）或yarn.lock（yarn）文件
  3. 重新执行安装命令

• 手动适配Realm版本与原生环境

  1. 尝试安装Realm稳定版本，例如：

     npm install realm@11.10.1
     # 或 yarn add realm@11.10.1
     

  2. iOS环境：进入项目ios目录执行pod install，完成后回到根目录重新安装Realm
  3. Android环境：检查android/build.gradle中的minSdkVersion是否≥21，不符合则修改后重试

• 开启verbose日志定位问题
  执行带日志的安装命令，查看具体卡顿环节：

  # npm
  npm install realm --verbose
  # yarn
  yarn add realm --verbose
  

  根据日志判断是网络下载受阻，还是原生编译环境缺失。

• 排查网络环境
  Realm安装过程需下载预编译二进制包，若网络受限（如内网、防火墙）会导致卡顿。切换至稳定网络，或配置合法代理后重试。

• 确认原生开发环境配置

  • iOS：确保Xcode为最新稳定版，已安装Command Line Tools
  • Android：确认Android SDK、NDK版本符合Realm要求，ANDROID_HOME、JAVA_HOME环境变量配置正确

内容的提问来源于stack exchange，提问作者Engr.Aftab Ufaq