Laravel TALL栈执行npm run dev报--openssl-legacy-provider不允许在NODE_OPTIONS设置如何解决

根本原因 #

该报错为Laravel Mix版本与本地Node.js版本的兼容性冲突导致：

• Node.js 17及以上版本内置OpenSSL 3.0，默认禁用了旧版非安全加密算法，低于6.0.36版本的Laravel Mix为兼容高版本Node的构建需求，会自动在NODE_OPTIONS环境变量中注入--openssl-legacy-provider参数启用旧加密算法
• 你本地macOS环境的Node.js版本为16.x及更低版本，该版本不识别--openssl-legacy-provider参数，因此执行npm run dev时直接抛出参数不允许的报错
• 你后续将Laravel Mix升级到6.0.39版本，该版本已修复参数注入逻辑：仅当检测到当前Node.js版本≥17时才注入兼容参数，因此报错自动消失
• 此前Homestead环境可正常运行，是因为该环境的Node版本与Laravel Mix版本没有触发上述冲突逻辑，要么Node版本≥17支持该参数，要么自带兼容适配。

可行解决方案 #

除已验证的升级Laravel Mix方案外，还有以下可选方案：

• 切换本地Node.js版本到16.x LTS版本：无需调整项目依赖，16.x长期支持版不会触发OpenSSL兼容问题，旧版Laravel Mix可正常运行
• 升级本地Node.js版本到17及以上：如果希望保持当前Laravel Mix版本不变，升级Node到17+版本即可原生支持--openssl-legacy-provider参数，不会抛出识别错误
• 手动修改package.json执行命令：不想调整依赖和Node版本的前提下，可直接修改脚本命令，提前清空冲突参数：

  "scripts": {
    "dev": "unset NODE_OPTIONS && npm run development",
    "development": "unset NODE_OPTIONS && mix",
    "production": "unset NODE_OPTIONS && mix --production"
  }
  

  Windows环境下将unset NODE_OPTIONS替换为set NODE_OPTIONS=即可生效
• 使用Node版本管理工具隔离环境：安装nvm等版本管理工具，可针对不同项目一键切换适配的Node版本，避免多项目间的依赖版本冲突。

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