.NET 4.8项目通过PowerShell构建时出现MSB4041错误求助

问题描述 #

通过PowerShell执行MSBuild命令构建.NET 4.8项目时触发MSB4041错误，错误提示：

项目的默认XML命名空间必须是MSBuild XML命名空间。若项目采用MSBuild 2003格式编写，请向元素添加xmlns="http://schemas.microsoft.com/developer/msbuild/2003"；若为旧版1.0或1.2格式，请转换为MSBuild 2003格式。

涉及的项目文件内容：

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net48</TargetFramework>
  </PropertyGroup>
</Project>

使用的PowerShell命令：

Add-Content $BuildOutput (msbuild "$RepoDirectory\src\MyProject.Api.csproj" /t:Publish /p:Configuration=Release /p:OutputPath="$ReleaseDirectory\MyProject.Api")

解决方案 #

1. 修复项目文件的命名空间问题 #

针对.NET Framework 4.8的SDK风格项目，部分旧版MSBuild环境需要显式声明MSBuild命名空间，修改<Project>元素添加命名空间属性即可：

<Project Sdk="Microsoft.NET.Sdk.Web" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

  <PropertyGroup>
    <TargetFramework>net48</TargetFramework>
  </PropertyGroup>
</Project>

2. 优化PowerShell命令执行方式 #

原命令直接将msbuild的输出作为参数传递给Add-Content，可能引发编码或输出截断问题，建议先捕获输出再写入文件：

$msbuildOutput = msbuild "$RepoDirectory\src\MyProject.Api.csproj" /t:Publish /p:Configuration=Release /p:OutputPath="$ReleaseDirectory\MyProject.Api"
Add-Content $BuildOutput $msbuildOutput

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