React项目安装node_modules失败：npm install执行报错求助

克隆了一个未包含node_modules的老旧React项目，执行npm install安装依赖时失败，尝试npm i --force也无法解决，安装过程中出现如下编译警告（最终导致安装终止）：

npm ERR! In file included from ../deps/grpc/src/core/lib/channel/channel_stack.h:47:
npm ERR! In file included from ../deps/grpc/src/core/lib/iomgr/call_combiner.h:30:
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:83:59: warning: unused parameter 'trace_flag' [-Wunused-parameter]
npm ERR!   constexpr explicit RefCount(Value init = 1, TraceFlagT* trace_flag = nullptr)
npm ERR!                                                           ^
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:103:33: warning: unused parameter 'location' [-Wunused-parameter]
npm ERR!   void Ref(const DebugLocation& location, const char* reason, Value n = 1) {
npm ERR!                                 ^
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:103:55: warning: unused parameter 'reason' [-Wunused-parameter]
npm ERR!   void Ref(const DebugLocation& location, const char* reason, Value n = 1) {
npm ERR!                                                       ^
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:129:40: warning: unused parameter 'location' [-Wunused-parameter]
npm ERR!   void RefNonZero(const DebugLocation& location, const char* reason) {
npm ERR!                                        ^
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:129:62: warning: unused parameter 'reason' [-Wunused-parameter]
npm ERR!   void RefNonZero(const DebugLocation& location, const char* reason) {
npm ERR!                                                              ^
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:153:42: warning: unused parameter 'location' [-Wunused-parameter]
npm ERR!   bool RefIfNonZero(const DebugLocation& location, const char* reason) {
npm ERR!                                          ^
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:153:64: warning: unused parameter 'reason' [-Wunused-parameter]
npm ERR!   bool RefIfNonZero(const DebugLocation& location, const char* reason) {
npm ERR!                                                                ^
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:184:35: warning: unused parameter 'location' [-Wunused-parameter]
npm ERR!   bool Unref(const DebugLocation& location, const char* reason) {
npm ERR!                                   ^
npm ERR! ../deps/grpc/src/core/lib/gprpp/ref_counted.h:184:57: warning: unused parameter 'reason' [-Wunused-parameter]
npm ERR!   bool Unref(const DebugLocation& location, const char* reason) {

可行解决方案： #

• 降级Node.js版本：老旧原生依赖（如grpc）和高版本Node.js兼容性差，建议切换到Node.js 14或12版本（用nvm管理：nvm install 14，随后nvm use 14），再执行npm install
• 忽略编译警告并强制安装：执行命令npm install --legacy-peer-deps --unsafe-perm，--legacy-peer-deps处理老旧依赖的peer依赖冲突，--unsafe-perm解决编译时权限问题
• 替换grpc依赖：若项目直接依赖旧版本grpc，将其替换为纯JS实现的@grpc/grpc-js，修改package.json后删除package-lock.json和node_modules，重新安装
• 清理缓存后重试：先执行npm cache clean --force，删除node_modules和package-lock.json，再执行npm install --legacy-peer-deps

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