SAFE Stack前置依赖安装问题及版本兼容报错咨询

问题背景与现象 #

SAFE Stack文档要求安装npm作为构建前置依赖，但npm默认随Node.js捆绑，疑惑文档为何单独指向npm官网；尝试通过NuGet安装npm后，出现两类问题：

1. Visual Studio运行模板触发NullReferenceException #

在helpers.fs的runOrDefault函数中，执行Target.runOrDefault "Run"时抛出空引用异常：

let runOrDefault args =
try
    match args with
    | [| target |] -> Target.runOrDefault target
    | _ -> Target.runOrDefault "Run" //NullReferenceException
    0
with e ->
    printfn "%A" e
    1

2. 命令行执行dotnet run触发Node版本不兼容错误 #

使用Node.js 19.0.0（npm 8.19.2）时，报错要求Node版本为~16、npm版本为~8：

Starting target 'InstallClient'
.> "C:\Program Files\nodejs\npm.CMD" install (In: false, Out: false, Err: false)
npm ERR! code EBADENGINE
npm ERR! engine Unsupported engine
npm ERR! engine Not compatible with your version of node/npm: undefined
npm ERR! notsup Not compatible with your version of node/npm: undefined
npm ERR! notsup Required: {"node":"~16","npm":"~8"}
npm ERR! notsup Actual:   {"npm":"8.19.2","node":"v19.0.0"}

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\User\AppData\Local\npm-cache\_logs\2022-11-04T11_38_04_408Z-debug-0.log
Finished (Failed) 'InstallClient' in 00:00:02.0540071

切换到Node.js 18.12.0 LTS版本后，仍触发相同版本不兼容错误：

Starting target 'InstallClient'
.> "C:\Program Files\nodejs\npm.CMD" install (In: false, Out: false, Err: false)
npm ERR! code EBADENGINE
npm ERR! engine Unsupported engine
npm ERR! engine Not compatible with your version of node/npm: undefined
npm ERR! notsup Not compatible with your version of node/npm: undefined
npm ERR! notsup Required: {"node":"~16","npm":"~8"}
npm ERR! notsup Actual:   {"npm":"8.19.2","node":"v18.12.0"}

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\User\AppData\Local\npm-cache\_logs\2022-11-04T13_19_03_959Z-debug-0.log
Finished (Failed) 'InstallClient' in 00:00:01.9942657

---------------------------------------------------------------------
Build Time Report
---------------------------------------------------------------------
Target          Duration
------          --------
Clean           00:00:00.5118885
InstallClient   00:00:01.9937254   (Process exit code '1' <> 0. Command Line: C:\Program Files\nodejs\npm.CMD install)
Run             00:00:00           (skipped)
Total:          00:00:02.6111670
Status:         Failure
---------------------------------------------------------------------
Fake.Core.BuildFailedException: Target 'InstallClient' failed.

解决方案 #

1. 解决Node版本兼容问题 #

SAFE Stack模板的package.json中指定了Node版本约束为~16，需安装对应版本的Node.js：

• 下载Node.js 16.x系列的LTS版本（如16.20.2），其自带的npm版本符合~8要求
• 安装后，通过命令行验证版本：

  node --version # 应显示v16.x.x
  npm --version  # 应显示8.x.x
  

• 若已安装多版本Node，可使用Node版本管理器（nvm）切换到16.x版本，避免全局版本冲突

2. 解决NullReferenceException问题 #

该异常通常因构建脚本依赖的FAKE工具未正确初始化，或项目依赖未完整安装导致：

• 先通过命令行完成dotnet run的依赖安装（解决版本问题后执行），再回到Visual Studio运行
• 清理项目缓存：删除obj、bin目录以及客户端的node_modules目录，重新构建
• 卸载通过NuGet安装的npm包，npm应随Node.js全局安装，NuGet版本会与全局版本冲突

额外说明 #

SAFE Stack文档指向npm官网是因为部分用户可能通过包管理器单独安装npm，但常规场景下直接安装Node.js即可获取npm，无需安装NuGet版本的npm。

内容的提问来源于stack exchange，提问作者Miroslav Husťák