Windows环境下npm安装kurento-client多版本尝试均失败求助

API 探路者

2026-7-25

解决Windows环境下kurento-client安装失败的问题

问题概述

尝试通过npm安装kurento-client，包括降低版本（参考过官方版本列表），但始终无法成功安装，当前环境为Windows系统，项目的package.json如下：

{
  "name": "fidb",
  "version": "1.0.0",
  "description": "kurento-one2many-call =====================",
  "main": "server.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node server.js"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "express": "^4.18.2",
    "minimist": "^1.2.8",
    "ws": "^8.13.0"
  }
}

解决方案

检查Node.js版本兼容性：kurento-client对Node.js版本有特定要求，建议安装Node.js 14.x或16.x LTS版本（部分高版本kurento-client不支持Node.js 18+）。执行以下命令查看当前版本：
```
node -v
```
版本不符则卸载后安装对应LTS版本。
清理npm缓存后重装：缓存损坏可能导致安装失败，执行命令清理缓存：
```
npm cache clean --force
```
删除项目下的node_modules文件夹和package-lock.json文件，再指定版本安装：
```
npm install kurento-client@6.18.0
```
安装Windows编译依赖：kurento-client部分依赖需要编译二进制文件，以管理员身份打开PowerShell执行：
```
npm install --global windows-build-tools
```
安装完成后重启终端，再尝试安装kurento-client。
切换国内镜像源：国内网络环境下可切换镜像源加速下载：
```
npm config set registry https://registry.npmmirror.com/
```
之后再执行安装命令即可。
检查防火墙/代理设置：暂时关闭代理或防火墙，避免拦截npm的包下载请求，之后重新尝试安装。