背景与需求场景痛点

• 前端代码依赖 Node.js/npm 进行构建，不可避免地需要拉取二进制文件。
• 国外默认源如 nodejs.org、registry.npmjs.org，经常抽风，影响开发效率。
• 项目在 CI/CD 或本地环境频繁遇到超时、下载失败等问题，导致流程不稳定。

操作步骤详解

1. 修改 pom.xml，引入国内镜像配置

Atlas 项目前端子模块通常采用 frontend-maven-plugin 实现 Node.js 和 npm 的自动安装。我们要做的就是在 plugin 的 execution 配置中手动指定国内加速源。

以下为关键配置片段（适用于 v2 和 v3 两个前端模块，建议两处都加上）：

<execution>
    <id>install node and npm</id>
    <goals>
        <goal>install-node-and-npm</goal>
    </goals>
    <configuration>
        <nodeVersion>${node-for-v2.version}</nodeVersion>
        <npmVersion>${npm-for-v2.version}</npmVersion>
        <nodeDownloadRoot>https://cdn.npmmirror.com/binaries/node/</nodeDownloadRoot>
        <npmDownloadRoot>https://registry.npmmirror.com/npm/-/</npmDownloadRoot>
    </configuration>
</execution>

笔记

• ${node-for-v2.version}、${npm-for-v2.version} 为你项目本身已有的版本号变量，无需手动填写，保证和整体依赖管理一致。
• nodeDownloadRoot 与 npmDownloadRoot 均切换到 npmmirror（原淘宝镜像），支持高并发与断点续传，速度极快。

2. 两个前端子模块都要加

如图所示，v2、v3 的 pom.xml 都需同步配置，否则仍有部分流程会因默认拉取失败：