问题：cordova prepare 报错 cannot find module node:stream 如何解决？

Question

在使用 Cordova 构建混合应用时，开发者可能会遇到执行 `cordova prepare` 命令时报错：`cannot find module 'node:stream'`。该问题通常出现在 Cordova 或其依赖插件与当前 Node.js 版本不兼容，尤其是 Node.js 版本过低或过高时。`node:stream` 是 Node.js 内置模块之一，正常情况下无需手动安装。解决方法包括：1）升级 Cordova 及相关插件至最新版本；2）降级或升级 Node.js 至与项目兼容的版本（推荐使用 Node.js 16.x 或 18.x）；3）检查 `package.json` 中的依赖版本，确保无冲突；4）清除 npm 缓存并重新安装依赖。通过以上步骤，通常可有效解决该模块缺失问题。

Answer 1

一、问题背景与现象描述

在使用 Cordova 构建混合应用时，开发者可能会遇到执行 cordova prepare 命令时报错：

Error: Cannot find module 'node:stream'

该错误表明 Node.js 在执行过程中无法找到内置模块 stream，而该模块是 Node.js 标准库的一部分，正常情况下无需手动安装。

此问题通常出现在 Cordova 或其依赖插件与当前 Node.js 版本不兼容时，尤其是在 Node.js 版本过低或过高时。

二、问题原因分析

• Node.js 版本不兼容： Cordova 及其插件依赖特定版本的 Node.js。如果当前 Node.js 版本（如 v14 或 v20）与项目所依赖的 Cordova 版本不兼容，就可能出现模块找不到的问题。
• 插件版本过旧： 某些 Cordova 插件可能未适配新版 Node.js 中的模块路径（如 node:stream）。
• 依赖缓存异常： npm 缓存或 node_modules 文件夹可能残留旧版本依赖，导致模块加载失败。
• package.json 配置不当： 项目依赖版本冲突，或指定了不兼容的 Cordova 版本。

三、解决方案详解

以下是按优先级排序的解决步骤，建议依次尝试：

1. 升级 Cordova 及相关插件至最新版本

更新 Cordova 及其插件可确保兼容性问题得到修复：

npm install -g cordova@latest
cordova platform update android@latest
cordova plugin update

2. 调整 Node.js 版本（推荐 16.x 或 18.x）

Node.js v14 已进入维护期，v20 可能引入不兼容变更。建议使用 Node.js v16 或 v18：

nvm install 16
nvm use 16

或使用 nvm 安装并切换 Node.js 18：

nvm install 18
nvm use 18

3. 检查 package.json 中的依赖版本

确保 Cordova 及插件版本与当前 Node.js 兼容，例如：

{
  "dependencies": {
    "cordova": "^12.0.0",
    "cordova-android": "^12.0.0"
  }
}

可参考官方文档确认版本兼容性。

4. 清除 npm 缓存并重新安装依赖

执行以下命令清除缓存并重新安装：

npm cache clean --force
rm -rf node_modules
npm install

四、版本兼容性对照表

Node.js 版本	Cordova 最佳兼容版本	备注
v14.x	Cordova 9.x - 10.x	逐步淘汰，建议升级
v16.x	Cordova 10.x - 11.x	推荐使用
v18.x	Cordova 11.x - 12.x	推荐使用
v20.x	Cordova 12.x+	可能存在插件兼容性问题

五、流程图：问题排查与解决流程

graph TD
    A[执行 cordova prepare 报错] --> B{检查 Node.js 版本}
    B -->|版本过低| C[升级 Node.js 至 16/18]
    B -->|版本过高| D[降级 Node.js 至 18 或以下]
    B -->|正常| E[检查 Cordova 及插件版本]
    E --> F{是否为最新版本}
    F -->|否| G[升级 Cordova 及插件]
    F -->|是| H[检查 package.json 依赖冲突]
    H --> I{是否有冲突}
    I -->|是| J[调整依赖版本]
    I -->|否| K[清除 npm 缓存并重装依赖]
    K --> L[问题解决]
    G --> L
    J --> K
    C --> M[重新执行 prepare]
    D --> M
    M --> L