VS2017下C# UWP控制台应用编译异常问题求助

问题基础信息 #

• 技术栈组合：C# + UWP 控制台应用 + Visual Studio 2017
• 项目来源：基于网络获取的VS2019适配C# UWP控制台模板降级搭建，因团队构建机固定使用VS2017环境，未升级开发工具版本
• 项目规模与功能：总代码量不足700行，核心逻辑为BLE设备连接、指定特征值注册、接收数据打印、通过TCP/IP将数据上传至服务器做可视化展示
• 已完成配置：应用清单中已勾选蓝牙、TCP/IP通信相关权限
• 项目版本配置：最低支持系统版本、目标系统版本均设置为 Windows 10 2004（内部版本19041）

已确认的异常规律 #

Release模式异常 #

• 无论选择x86还是x64目标架构，Release模式始终编译失败，累计抛出168个错误
• 其中100+错误为程序集加载失败，核心报错：

Loading assembly "XXX.dll" failed. System.IO.FileNotFoundException: Could not load file or assembly 'System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies. The system cannot find the file specified.

• 报错涉及上百个不同的系统类库DLL，全部与System.Private.CoreLib加载失败相关

Debug模式异常 #

• 首次执行编译必然失败，仅提示System.Runtime.dll加载失败，根因同样指向System.Private.CoreLib依赖缺失
• 首次编译失败后执行Clean Solution（清理解决方案）后重新编译，可正常完成编译链接
• 再次执行「清理+编译」操作会复现报错，再重复一次清理+编译错误又会消失，编译结果在成功、失败状态无限交替，无稳定单次触发规律
• 该场景兼容性问题无公开可直接复用的解决方案

可落地排查解决步骤 #

• 第一步：修正SDK版本不兼容问题。VS2017无官方适配Windows 10 2004（19041）SDK的支持，最高原生兼容SDK版本为Windows 10 1903（18362），这是核心库加载错乱的根因。将项目目标系统版本、最低支持版本下调至18362或更低的VS2017兼容SDK版本，重新加载项目。
• 第二步：修复项目引用错乱。第三方下载的高版本模板降级后会残留手动引入的核心库引用，和VS2017 UWP SDK的自动引用规则冲突。右键项目选择「卸载项目」，再选择「编辑csproj文件」，删除所有手动添加的System.Private.CoreLib、System.Runtime等基础运行时库的Reference条目，保存后重新加载项目。
• 第三步：彻底清除编译缓存。关闭所有VS2017窗口，手动删除项目根目录下的.vs隐藏文件夹、所有项目下的bin、obj文件夹；打开VS2017开发者命令提示符，执行nuget locals all -clear清空全局NuGet包缓存，解决Debug模式下编译结果交替成功失败的缓存错乱问题。
• 第四步：Release模式专项配置校验。重新打开项目后进入属性页-生成选项卡，确认Release模式下「使用.NET Native工具链编译」选项保持模板默认勾选状态，不要手动修改.NET Native工具链的引用路径，避免和当前SDK版本不匹配。
• 第五步：配置回检。完成上述修改后重新编译，检查应用清单文件中的蓝牙、网络权限配置是否因SDK版本下调丢失，补全缺失的权限配置即可。

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