Clever Cloud部署NextJS时如何为npm install传递自定义参数

优先推荐使用项目级.npmrc配置解决，无平台适配成本，不会触发递归问题，能保证本地开发和部署环境的依赖安装行为一致：

• 在项目根目录新建/编辑.npmrc文件，写入以下配置：

legacy-peer-deps=true
strict-peer-deps=false

• 将该文件提交到代码仓库，重新触发Clever Cloud部署即可。平台默认执行的npm install --no-progress会自动读取该配置，等价于给所有install命令默认加上--legacy-peer-deps参数，直接绕过peer依赖严格校验。

之前操作失效的原因 #

• 配置CC_NODE_BUILD_TOOL/CC_CUSTOM_BUILD_TOOL无效：
  CC_NODE_BUILD_TOOL仅支持传入npm/yarn/pnpm这类构建工具类型标识，不识别带参数的完整命令；CC_CUSTOM_BUILD_TOOL会直接跳过Clever Cloud默认的Node.js全构建流程，仅执行传入的单条命令，后续的依赖校验、项目构建步骤都会被跳过，自然无法解决安装阶段的报错。
• 修改scripts.install字段导致递归：
  npm执行install操作时会自动触发package.json中scripts.install定义的生命周期脚本，如果在该脚本内再次写入npm install相关命令，就会循环触发自身调用，出现无限递归的问题。

备选方案（自定义安装命令） #

如果不想新增.npmrc文件，可以使用Clever Cloud专门提供的安装命令覆盖环境变量：

• 在Clever Cloud应用的环境变量配置中，新增CC_INSTALL_COMMAND，值设为npm install --no-progress --legacy-peer-deps
• 保存配置后重新部署，平台会直接用这条命令替换默认的安装命令，不会触发npm生命周期脚本的递归问题。

关于strict-peer-deps=false的可行性 #

完全支持。这个配置是npm官方提供的功能开关，设置为false后会关闭npm v7及以上版本默认开启的严格peer依赖校验，和--legacy-peer-deps参数的核心效果一致，是Next.js项目解决第三方依赖peer冲突的常规操作，只要本地验证过依赖不存在实际运行时兼容问题，生产环境使用没有风险。

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