TeamCity构建步骤执行nvm use切换Node版本失效问题求助

问题背景 #

在TeamCity部署环境中，需为不同项目使用不同Node版本。已通过frontend-maven-plugin安装对应Node版本，Agent机器也手动安装了该版本。尝试在Maven构建前添加命令行构建步骤执行nvm use 18切换版本：

• 在Agent窗口打开的终端中执行该命令可正常生效
• 通过TeamCity构建步骤（命令行或PowerShell）执行时，进程持续运行且版本未切换

附带的frontend-maven-plugin配置如下：

<plugin>
    <groupId>com.github.eirslett</groupId>
    <artifactId>frontend-maven-plugin</artifactId>
    <version>1.12.1</version>
    <executions>
        <execution>
            <id>install node and npm</id>
            <goals>
                <goal>install-node-and-npm</goal>
            </goals>
            <!-- optional: default phase is "generate-resources" -->
            <phase>generate-resources</phase>
        </execution>
        <execution>
            <id>maven run install</id>
            <goals>
                <goal>npm</goal>
            </goals>
            <phase>generate-resources</phase>
            <configuration>
                <arguments>install</arguments>
            </configuration>
        </execution>
        <execution>
            <id>maven run angular build-web-prod</id>
            <goals>
                <goal>npm</goal>
            </goals>
            <phase>generate-resources</phase>
            <configuration>
                <arguments>run build-file-prod</arguments>
            </configuration>
        </execution>
    </executions>
    <configuration>
        <nodeVersion>v18.17.0</nodeVersion>
        <npmVersion>9.6.7</npmVersion>
    </configuration>
</plugin>

解决方案 #

1. 直接使用frontend-maven-plugin内置的Node版本（推荐）

你已经通过插件指定了nodeVersion和npmVersion，插件会自动在项目的target/node目录下下载并安装对应版本，后续执行npm install、npm run build-file-prod等命令时，会自动使用这个独立的Node环境，完全不需要依赖Agent机器上的nvm或全局Node版本。

这种方式无需额外的切换步骤，且能保证每个项目使用的Node版本完全一致，不受Agent环境影响。

2. 修复TeamCity中nvm命令的执行问题

如果必须使用nvm切换版本，问题根源在于TeamCity的构建步骤是独立的非交互式进程，nvm的初始化脚本默认不会自动加载：

• PowerShell步骤：先加载nvm的PowerShell脚本再执行切换：

  & "$env:USERPROFILE\.nvm\ps\nvm.ps1" use 18
  

• CMD命令行步骤：先通过call初始化nvm环境再切换：

  call %USERPROFILE%\.nvm\nvm.cmd use 18
  

• 注意：TeamCity的每个构建步骤是独立进程，所以要把nvm切换和Maven命令放在同一个步骤中执行，才能让Maven使用切换后的版本：

  call %USERPROFILE%\.nvm\nvm.cmd use 18 && mvn clean install
  

3. 通过TeamCity构建参数指定Node版本

在TeamCity中配置全局参数，直接指定Node版本的路径，避免nvm切换的麻烦：

1. 在Agent机器上记录目标Node版本的安装路径（比如nvm安装的v18.17.0路径为C:\Users\你的用户名\.nvm\v18.17.0）
2. 在TeamCity项目的构建参数中添加env.NODE_HOME，值为上述路径
3. 修改Maven构建步骤，将Node路径加入系统PATH后再执行Maven命令：

set PATH=%NODE_HOME%;%PATH% && mvn clean install

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