搭建opentelemetry.io开发环境时遇npm ERR! code 1错误求助

问题详情 #

在Ubuntu 23.10系统上，通过npm搭建opentelemetry.io（代码仓库：https://github.com/open-telemetry/opentelemetry.io）开发环境时，执行npm install报错，错误核心为hugo-extended包的postinstall.js脚本执行失败，具体输出如下：

npm WARN deprecated source-map-url@0.4.1: See https://github.com/lydell/source-map-url#deprecated
...（其他弃用警告）
npm ERR! code 1
npm ERR! path /home/rafe/Desktop/opentelemetryio/node_modules/hugo-extended
npm ERR! command failed
npm ERR! command sh -c node postinstall.js

完整日志路径：/home/rafe/.npm/_logs/2024-03-10T06_00_26_721Z-debug-0.log

系统信息 #

• OS: Ubuntu 23.10
• npm版本: 10.5.0
• Node.js版本: v20.11.1

已尝试的操作 #

• 清理npm缓存：npm cache clean --force
• 重新执行依赖安装：npm install

解决方案建议 #

1. 查看详细错误日志定位原因 #

先读取完整debug日志，聚焦postinstall阶段的具体报错：

cat /home/rafe/.npm/_logs/2024-03-10T06_00_26_721Z-debug-0.log

重点关注下载失败、权限不足、系统依赖缺失等关键信息。

2. 手动执行postinstall脚本排查 #

进入hugo-extended包目录，直接运行脚本获取实时错误输出：

cd /home/rafe/Desktop/opentelemetryio/node_modules/hugo-extended
node postinstall.js

根据输出的具体问题针对性处理。

3. 解决网络/下载问题 #

若报错为hugo二进制包下载失败：

• 检查网络连通性，必要时切换网络或配置npm代理
• 手动下载适配Ubuntu 23.10的hugo-extended二进制包，替换到node_modules/hugo-extended脚本指定的存储路径（可查看postinstall.js中的下载地址和文件名）

4. 安装系统依赖库 #

Ubuntu运行hugo-extended需要基础系统依赖，执行以下命令安装：

sudo apt update && sudo apt install -y libc6 libstdc++6 libgcc-s1

5. 调整Node.js/npm版本 #

部分版本组合可能存在兼容性问题，可通过nvm切换到更稳定的版本（如Node.js 18.x + npm 9.x）：

# 安装nvm（未安装时执行）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装并切换到Node.js 18
nvm install 18
nvm use 18
# 重新安装依赖
npm install

6. 指定兼容的hugo-extended版本 #

查看opentelemetry.io仓库package.json中指定的hugo-extended版本，若该版本与Ubuntu 23.10不兼容，尝试安装适配版本：

npm install hugo-extended@<兼容版本号>

内容的提问来源于stack exchange，提问作者Rafe