首次在Netlify部署站点时依赖安装失败问题求助

首次在Netlify发布站点时，遇到依赖安装失败的错误，错误日志如下：

7:24:28 PM: build-image version: 3d3c7e8b4321e2c1a54a2c4584fb46ba742b1630 (focal)
7:24:28 PM: buildbot version: 72ed9578274f76ae72cdce4c5312615aeecc32fb
7:24:28 PM: Building without cache
7:24:28 PM: Starting to prepare the repo for build
7:24:29 PM: No cached dependencies found. Cloning fresh repo
7:24:29 PM: git clone --filter=blob:none https://github.com/Essama-Official/Fictum.Web
7:24:29 PM: Preparing Git Reference refs/heads/main
7:24:31 PM: Starting to install dependencies
7:24:32 PM: Python version set to 3.8
7:24:32 PM: Attempting Ruby version 2.7.2, read from environment
7:24:32 PM: Using Ruby version 2.7.2
7:24:33 PM: Started restoring cached go cache
7:24:33 PM: Finished restoring cached go cache
7:24:35 PM: go version go1.19.13 linux/amd64
7:24:36 PM: Using PHP version 8.0
7:24:37 PM: v18.20.2 is already installed.
7:24:38 PM: Now using node v18.20.2 (npm v10.5.0)
7:24:38 PM: Enabling Node.js Corepack
7:24:38 PM: Started restoring cached build plugins
7:24:38 PM: Finished restoring cached build plugins
7:24:38 PM: Started restoring cached corepack dependencies
7:24:38 PM: Finished restoring cached corepack dependencies
7:24:38 PM: No npm workspaces detected
7:24:38 PM: Started restoring cached node modules
7:24:38 PM: Finished restoring cached node modules
7:24:38 PM: Installing npm packages using npm version 10.5.0
7:24:39 PM: Failed during stage 'Install dependencies': dependency_installation script returned non-zero exit code: 1
7:24:39 PM: npm ERR! code ERESOLVE
7:24:39 PM: npm ERR! ERESOLVE could not resolve
7:24:39 PM: npm ERR!
7:24:39 PM: npm ERR! While resolving: vue-lottie@0.2.1
7:24:39 PM: npm ERR! Found: vue@3.4.25
7:24:39 PM: npm ERR! node_modules/vue
7:24:39 PM: npm ERR!   vue@"^3.3.11" from the root project
7:24:39 PM: npm ERR!   peer vue@"^3.2.25" from @vitejs/plugin-vue@4.6.2
7:24:39 PM: npm ERR!   node_modules/@vitejs/plugin-vue
7:24:39 PM: npm ERR!     dev @vitejs/plugin-vue@"^4.5.2" from the root project
7:24:39 PM: npm ERR!   4 more (@vue/server-renderer, vue-chartjs, vue-router, vuex)
7:24:39 PM: npm ERR!
7:24:39 PM: npm ERR! Could not resolve dependency:
7:24:39 PM: npm ERR! peer vue@"^2.5.16" from vue-lottie@0.2.1
7:24:39 PM: npm ERR! node_modules/vue-lottie
7:24:39 PM: npm ERR!   vue-lottie@"^0.2.1" from the root project
7:24:39 PM: npm ERR!
7:24:39 PM: npm ERR! Conflicting peer dependency: vue@2.7.16
7:24:39 PM: npm ERR! node_modules/vue
7:24:39 PM: npm ERR!   peer vue@"^2.5.16" from vue-lottie@0.2.1
7:24:39 PM: npm ERR!   node_modules/vue-lottie
7:24:39 PM: npm ERR!     vue-lottie@"^0.2.1" from the root project
7:24:39 PM: npm ERR!
7:24:39 PM: npm ERR! Fix the upstream dependency conflict, or retry
7:24:39 PM: npm ERR! this command with --force or --legacy-peer-deps
7:24:39 PM: npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
7:24:39 PM: npm ERR!
7:24:39 PM: npm ERR!
7:24:39 PM: npm ERR! For a full report see:
7:24:39 PM: npm ERR! /opt/buildhome/.npm/_logs/2024-05-14T17_24_38_567Z-eresolve-report.txt
7:24:39 PM: npm ERR! A complete log of this run can be found in: /opt/buildhome/.npm/_logs/2024-05-14T17_24_38_567Z-debug-0.log
7:24:39 PM: Error during npm install
7:24:39 PM: Failing build: Failed to install dependencies

已尝试以下方法但未解决：

• 执行命令 npm install vue-lottie@latest --save
• 执行命令 npm install --legacy-peer-deps
• 修改Netlify构建设置：进入Site Settings > Build & Deploy > Continuous Deployment，编辑Build Command为CI= npm run build，设置Publish Directory为build

有效解决方案 #

方案1：替换为Vue3兼容的Lottie库（推荐）

vue-lottie@0.2.1仅支持Vue2，和项目中的Vue3存在版本冲突，直接替换为适配Vue3的库：

• 卸载旧依赖：npm uninstall vue-lottie
• 安装Vue3兼容的Lottie库：npm install @lottiefiles/vue-lottie-player --save
• 修改项目中所有引用vue-lottie的代码，替换为新库的使用方式（比如组件导入、调用语法）

方案2：强制Netlify使用legacy-peer-deps模式安装

本地执行npm install --legacy-peer-deps可能生效，但Netlify默认不会用这个参数，需要全局配置：

• 在项目根目录创建.npmrc文件，添加一行：legacy-peer-deps=true
• 将.npmrc提交到Git仓库，Netlify构建时会自动读取该配置，跳过peer依赖冲突检查

方案3：降级Vue版本（不推荐）

如果必须使用旧版vue-lottie，只能将Vue降级到2.x版本：

• 修改package.json中的vue版本为^2.7.16
• 执行npm install更新依赖
• 注意：此操作会导致其他Vue3专属依赖失效，需同步调整所有相关代码

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