ASP.NET Core应用意外引入Microsoft.WindowsDesktop.App依赖求助

排查步骤 #

• 检查类库目标框架：打开DataStuff.SqlData.csproj，确认<TargetFramework>节点是否为net6.0，而非net6.0-windows。若类库目标为Windows桌面框架，会自动引入Microsoft.WindowsDesktop.App依赖。
• 分析依赖链：在类库目录执行命令dotnet list package --include-transitive，查看是否有间接依赖的包引入了WindowsDesktop相关组件。重点排查Microsoft.Data.SqlClient之外的包，某些第三方包可能存在跨平台版本与桌面版本的差异。
• 检查项目文件配置：确认类库的.csproj中是否存在手动添加的<FrameworkReference Include="Microsoft.WindowsDesktop.App" />节点，或某个PackageReference包含了桌面专属的特性依赖。
• 检查代码实现：逐行检查SqlSetup类及相关代码，确认是否误引入了Windows桌面专属API（如System.Windows.Forms、WPF相关类型），哪怕是无用的using语句或反射调用，都可能触发运行时依赖。

解决方法 #

• 修正类库目标框架：若类库目标框架为net6.0-windows，将其改为net6.0，重新编译类库及API项目。
• 清理间接依赖：若发现某个第三方包引入了桌面依赖，替换为跨平台兼容版本；或在类库的.csproj中通过<PrivateAssets>all</PrivateAssets>配置排除该包的依赖传递，例如：

  <PackageReference Include="ProblematicPackage" Version="x.x.x">
    <PrivateAssets>all</PrivateAssets>
  </PackageReference>
  

• 移除多余框架引用：若.csproj中存在手动添加的Microsoft.WindowsDesktop.App框架引用，直接删除该节点并重新生成。
• 清理代码中的桌面API引用：删除所有与Windows桌面相关的代码、using语句，确保仅使用Microsoft.Data.SqlClient和ASP.NET Core跨平台API。

验证 #

修改完成后，重新生成整个解决方案，查看API项目的.runtimeconfig.json文件，确认Microsoft.WindowsDesktop.App依赖已移除，同时测试SqlSetup的初始化逻辑及SQL操作功能是否正常。

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