dotnet publish在Azure DevOps与本地环境中程序集版本不一致问题排查

原因分析 #

这种本地与Azure DevOps流水线的版本差异，核心原因是流水线环境中存在全局版本参数注入，覆盖了子项目的默认版本配置：

• 流水线可能通过MSBuild参数（如/p:Version=2.1.1.1）、Azure DevOps全局变量，或者解决方案根目录的Directory.Build.props/targets文件，为所有项目统一设置了Version或AssemblyVersion属性。
• 本地执行publish时无这些全局配置，因此只有MicroService1.Web使用自身配置的版本，其他项目保持默认的1.0.0.0。

解决方法 #

1. 移除全局版本参数，仅针对Web项目传递 #

检查流水线中的dotnet publish命令或DotNetCoreCLI任务配置，将全局版本参数改为仅针对MicroService1.Web项目传递：

dotnet.exe publish ./MicroService1.Web/MicroService1.Web.csproj --framework net6.0 --configuration Release --runtime win-x64 --self-contained true /p:Version=2.1.1.1

2. 显式指定子项目版本 #

在MicroService1和MicroService1.Core的项目文件中，显式设置自身版本属性，避免继承全局配置：

<PropertyGroup>
  <Version>1.0.0.0</Version>
  <AssemblyVersion>1.0.0.0</AssemblyVersion>
</PropertyGroup>

3. 修改全局构建配置文件规则 #

如果解决方案根目录存在Directory.Build.props或Directory.Build.targets文件，调整版本设置的条件，仅对Web项目生效：

<PropertyGroup Condition="'$(MSBuildProjectName)' == 'MicroService1.Web'">
  <Version>2.1.1.1</Version>
  <AssemblyVersion>2.1.1.1</AssemblyVersion>
</PropertyGroup>

4. 限制Azure DevOps变量作用范围 #

如果是通过Azure DevOps全局变量设置了Version，修改变量的作用范围为仅MicroService1.Web项目，或直接删除全局变量，改为在Web项目的构建任务中单独配置版本参数。

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