WinUI3项目EF Core迁移命令报错：WindowsAppSDKSelfContained需支持架构

问题根源 #

EF Core工具执行dotnet ef系列命令时，默认不会自动指定WinUI3项目所需的目标架构；而开启WindowsAppSDKSelfContained的项目必须明确指定支持的Windows架构（x64/x86/arm64），这就导致工具触发架构不匹配的构建错误。而dotnet build能成功，是因为IDE（如Visual Studio）或手动执行时会默认绑定当前机器的架构。

修复步骤 #

1. 临时快速修复：执行EF命令时显式指定架构 #

直接在EF命令后追加--arch参数，指定与开发机器匹配的架构，例如x64架构机器执行：

dotnet ef migrations list --arch x64

arm64设备则替换为--arch arm64，x86设备用--arch x86。

2. 永久修复：修改项目文件固定架构配置 #

编辑WinUI3项目的.csproj文件，在<PropertyGroup>节点中添加或明确以下配置，确保架构与自包含部署设置兼容：

<!-- 根据你的开发机器选择x64/x86/arm64 -->
<PlatformTarget>x64</PlatformTarget>
<!-- 对应架构的RuntimeIdentifier -->
<RuntimeIdentifier>win-x64</RuntimeIdentifier>
<!-- 保持自包含设置与RuntimeIdentifier匹配 -->
<WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>

如果需要支持多架构，可以用条件分支配置：

<PropertyGroup Condition="'$(Platform)' == 'x64'">
  <RuntimeIdentifier>win-x64</RuntimeIdentifier>
</PropertyGroup>
<PropertyGroup Condition="'$(Platform)' == 'arm64'">
  <RuntimeIdentifier>win-arm64</RuntimeIdentifier>
</PropertyGroup>

3. 验证修复 #

修改完成后重新执行EF命令，例如dotnet ef migrations list，即可正常执行无报错。

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