在AWS CodeBuild Windows环境中安装Node.js后无法调用的问题

问题 #

我在基于mcr.microsoft.com/dotnet/framework/sdk:4.8镜像的AWS CodeBuild构建服务器上，通过Chocolatey安装Node.js LTS版本，使用以下buildspec配置：

version: 0.2
phases:
  install:
    commands:
      - Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
      - Import-Module "C:\ProgramData\chocolatey\helpers\chocolateyProfile.psm1"
      - C:\ProgramData\chocolatey\bin\choco.exe install nodejs-lts -y
      - refreshenv
      - node -v

执行后，Node.js安装成功，但node -v提示找不到命令：

nodejs-lts has been installed.
  nodejs-lts may be able to be automatically uninstalled.
Environment Vars (like PATH) have changed. Close/reopen your shell to
 see the changes (or in powershell/cmd.exe just type `refreshenv`).
 The install of nodejs-lts was successful.
  Software installed as 'MSI', install location is likely default.

Chocolatey installed 1/1 packages. 
 See the log for details (C:\ProgramData\chocolatey\logs\chocolatey.log).
Refreshing environment variables from registry for cmd.exe. Please wait...Finished..
node : The term 'node' is not recognized as the name of a cmdlet, function, 
script file, or operable program. Check the spelling of the name, or if a path 
was included, verify that the path is correct and try again.

但如果将安装、刷新环境和验证命令合并为单行，就能正常运行：

version: 0.2
phases:
  install:
    commands:
      - Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
      - Import-Module "C:\ProgramData\chocolatey\helpers\chocolateyProfile.psm1"; C:\ProgramData\chocolatey\bin\choco.exe install nodejs-lts -y; refreshenv; node -v

请问如何让Node.js在后续的独立命令中正常可用？

解决方案 #

方法1：手动注入Node.js路径到环境变量 #

CodeBuild的每个独立命令会在新子进程中执行，refreshenv仅对当前进程生效。可以直接将Node.js默认安装路径（通常为C:\Program Files\nodejs\）添加到PATH，确保后续命令能识别：

version: 0.2
phases:
  install:
    commands:
      - Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
      - Import-Module "C:\ProgramData\chocolatey\helpers\chocolateyProfile.psm1"
      - C:\ProgramData\chocolatey\bin\choco.exe install nodejs-lts -y
      - $env:PATH = "C:\Program Files\nodejs\;$env:PATH"
      - node -v

方法2：将Node相关命令合并到同一进程 #

既然同一行命令能生效，说明当前进程环境变量已更新。把需要使用Node.js的后续命令和refreshenv放在同一个命令行，用分号分隔：

version: 0.2
phases:
  install:
    commands:
      - Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
      - Import-Module "C:\ProgramData\chocolatey\helpers\chocolateyProfile.psm1"; C:\ProgramData\chocolatey\bin\choco.exe install nodejs-lts -y; refreshenv; node -v; npm install

方法3：使用Chocolatey专属刷新命令 #

Chocolatey提供的choco refreshenv在PowerShell中环境变量更新更稳定，替换原生refreshenv：

version: 0.2
phases:
  install:
    commands:
      - Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
      - Import-Module "C:\ProgramData\chocolatey\helpers\chocolateyProfile.psm1"
      - C:\ProgramData\chocolatey\bin\choco.exe install nodejs-lts -y
      - choco refreshenv
      - node -v

方法4：通过CodeBuild全局环境变量配置PATH #

如果已知Node.js安装路径，直接在buildspec的env字段预配置，确保所有阶段命令都能访问：

version: 0.2
env:
  variables:
    PATH: "C:\\Program Files\\nodejs\\;%PATH%"
phases:
  install:
    commands:
      - Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
      - Import-Module "C:\ProgramData\chocolatey\helpers\chocolateyProfile.psm1"
      - C:\ProgramData\chocolatey\bin\choco.exe install nodejs-lts -y
      - node -v

内容的提问来源于stack exchange，提问作者Patrick Ryan