GitHub Actions构建报错：无法启动Node16容器，影响PR合并

报错信息 #

OCI runtime exec failed: exec failed: unable to start container process: exec: "/__e/node16_alpine/bin/node": stat /__e/node16_alpine/bin/node: no such file or directory: unknown

问题根源分析 #

结合GitHub Actions 2023年9月启动的Node.js 16到20迁移计划，这个报错的核心原因是构建环境已彻底移除预安装的Node.js 16版本：

• Node.js 16在2023年9月结束生命周期（EOL），GitHub Actions托管环境逐步下架该版本，到2024年11月已完全清除预安装的Node.js 16，导致旧路径/__e/node16_alpine/bin/node彻底失效。
• 若你的工作流依赖环境默认安装的Node.js 16，而非通过actions/setup-node主动管理版本，就会触发路径找不到的报错。
• 少数场景下可能是旧缓存或残留环境变量，导致脚本仍指向Node.js 16的旧路径，但实际环境已更新为Node.js 20。

解决建议 #

• 调整工作流的Node.js版本配置：
  打开.github/workflows下的构建配置文件，使用actions/setup-node动作明确管理版本：
  • 优先升级到Node.js 20（GitHub当前默认版本），修改配置如下：

    - name: Setup Node.js
      uses: actions/setup-node@v4
      with:
        node-version: '20'
    

  • 若必须保留Node.js 16（不建议，存在安全风险），需在setup-node中明确指定版本，确保动作主动安装该版本。
• 移除硬编码的Node路径：
  脚本中禁止使用/__e/node16_alpine/bin/node这类绝对路径，改用全局node命令（通过actions/setup-node配置后，Node会自动加入系统PATH）。
• 验证环境版本：
  在工作流中添加步骤确认当前Node版本，排查环境配置是否符合预期：

  - name: Check Node version
    run: node --version
  

• 清理缓存：
  若使用了actions/cache之类的缓存动作，暂时禁用缓存重新构建，排查是否是旧缓存导致的路径残留问题。

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