Github CI/CD中Nuget拉包时引用未定义NHibernate版本报错

核心原因：NHibernate 5.3.10的来源 #

你看到的未定义NHibernate 5.3.10引用，来自CustomerSimulator包的传递依赖链，触发逻辑如下：

1. 你在空临时目录下直接执行nuget install单个包的操作，完全脱离你的项目上下文，你项目中统一配置的NHibernate 5.2.0版本约束对该次操作没有任何效力，nuget只会根据你要安装的包本身的依赖链做解析
2. 不带-Framework参数执行命令时，nuget默认使用目标框架Any,Version=v0.0，不会根据目标框架过滤依赖，会尝试解析所有兼容的传递依赖
3. 你的传递依赖链中存在某个包对NHibernate的依赖只指定了下限（比如>=5.2.0）未指定上限，nuget默认的Lowest依赖行为在无框架约束的场景下，会拉取满足下限要求的最高稳定版本，也就是你看到的5.3.10

你可以执行nuget dependencies CustomerSimulator -Version 1.0.7982.10992 -Framework Any命令直接导出该包的全量传递依赖树，确认是哪个子依赖引入了无上限的NHibernate引用。

异常现象解释 #

异常1：加-Framework net461仅下载主包无依赖 #

这是nuget 5.x的已知行为：当你指定的框架标识和CustomerSimulator包的nuspec元数据中声明的依赖框架完全不匹配时，nuget会跳过所有依赖解析，只下载主包。你可以用nuget spec CustomerSimulator -Version 1.0.7982.10992导出包的元数据，检查它的依赖节点是否是用.NETFramework4.6.1而不是短名称net461声明的。

异常2：构建机不识别.NETFramework4.6.1参数 #

Github Windows 2019镜像预装的nuget版本虽然和你本地版本号一致，但存在系统层面的框架别名配置差异：本地完整版Windows环境的SDK会自动注册长框架名的别名，而构建机的最小化运行环境没有注册该别名，因此无法识别参数。

解决方案 #

你可以任选以下两种方式修复：

• 执行install命令时添加-DependencyVersion HighestMinor参数，同时指定-Framework net461，并在命令执行的同级目录下添加nuget.config文件，显式锁定NHibernate的版本：

<configuration>
  <packageSources>
    <!-- 保留你现有的包源配置 -->
  </packageSources>
  <packageVersionConstraints>
    <add packageId="NHibernate" version="[5.2.0]" />
  </packageVersionConstraints>
</configuration>

• 改用packages.config文件的方式批量安装包，在文件中显式指定所有要固定版本的包，再执行nuget install packages.config -OutputDirectory 你的目标目录 -Framework net461，这种方式的依赖解析优先级完全以你文件中指定的版本为准，不会自动升级传递依赖。

内容的提问来源于stack exchange，提问作者Alex F