Maven构建时NodeJS包下载异常（musl版本404）及配置咨询

出现musl包下载404的原因 #

• 你使用的Maven Node插件（大概率是frontend-maven-plugin）会自动检测构建机器的Linux系统libc类型：
  • 若构建机器是Alpine Linux这类采用musl libc的发行版，插件会自动尝试下载带-musl后缀的Node包；
  • 但Node.js v16.16.0的官方仓库并未提供该musl版本的包，因此触发404错误。

如何在pom.xml中固定下载的包 #

你可以通过以下几种配置方式，强制插件下载指定的Node包：

方式1：直接指定完整下载URL #

在插件的<configuration>中添加nodeDownloadUrl，硬编码为目标包的地址：

<configuration>
    <nodeVersion>v16.16.0</nodeVersion>
    <downloadRoot>https://nodejs.org/dist/</downloadRoot>
    <!-- 固定下载glibc版本的x64包 -->
    <nodeDownloadUrl>https://nodejs.org/dist/v16.16.0/node-v16.16.0-linux-x64.tar.gz</nodeDownloadUrl>
</configuration>

方式2：指定分类器跳过自动检测 #

通过classifier参数指定包的后缀，强制使用glibc版本：

<configuration>
    <nodeVersion>v16.16.0</nodeVersion>
    <downloadRoot>https://nodejs.org/dist/</downloadRoot>
    <!-- 指定分类器，覆盖自动检测结果 -->
    <classifier>linux-x64</classifier>
</configuration>

方式3：强制指定平台类型 #

使用platform参数固定目标平台，避免插件自动识别系统：

<configuration>
    <nodeVersion>v16.16.0</nodeVersion>
    <downloadRoot>https://nodejs.org/dist/</downloadRoot>
    <!-- 强制锁定Linux x64平台（对应glibc版本包） -->
    <platform>linux-x64</platform>
</configuration>

注：以上三种方式任选其一即可，推荐使用classifier或platform，后续升级Node版本时只需修改nodeVersion，无需调整其他配置。

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