Heroku运行出现Unexpected token '??='语法错误该如何排查？

??=是ES2021标准新增的逻辑空赋值运算符，仅Node.js v15.14.0及以上版本原生支持该语法，本次报错的根本原因是Heroku运行环境的Node.js版本过低，无法识别该语法标记。

• 先在本地开发环境执行node -v查看本地Node版本，如果本地版本≥15.14.0，即可确认是Heroku环境与本地环境的Node版本不匹配导致的问题
• 在项目根目录执行全局字符搜索：Linux/macOS环境执行grep -r "??=" .，Windows环境直接用资源管理器的全局文件搜索功能查找??=字符串，即可定位到项目自身代码或是第三方依赖中使用该语法的具体位置
• 检查项目根目录的package.json文件，确认是否配置了engines字段指定Node版本，未指定的情况下Heroku会默认使用当前的LTS版本，若项目依赖的第三方包是在高版本Node环境下编译的，也会触发该报错。

• 方案一：在package.json中明确指定Node版本要求，添加如下配置后重新提交部署即可，Heroku会自动拉取匹配版本的Node环境：

{
  "engines": {
    "node": ">=15.14.0"
  }
}

• 方案二：若不想升级Node版本，可手动兼容语法：将代码中所有a ??= b的写法替换为低版本兼容写法a = a ?? b，若需要兼容更低版本，可进一步替换为a = (a !== undefined && a !== null) ? a : b
• 方案三：如果是第三方依赖使用了该语法，可安装Babel转译插件@babel/plugin-proposal-logical-assignment-operators，在项目打包阶段对所有代码做语法转译，兼容低版本Node环境。

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