VS2019调试C++ CLR控制台程序时MCRTEXE.CPP报DLL加载失败

这是C++/CLI（CLR）项目的典型程序集加载问题，和MCRTEXE.cpp文件本身无关——这个文件是CLR控制台项目的默认启动入口，运行时最先加载依赖的阶段就会走到这里，所以异常会在这个位置抛出：

• C++ CLR项目和C#项目的生成逻辑不一样，添加托管DLL引用后，不会默认把引用的DLL拷贝到最终exe所在的输出目录。你把DLL放在项目源码目录里没有任何作用，CLR加载程序集默认不会扫描项目源码目录，只会找exe同级目录、GAC全局程序集缓存、系统环境变量配置的路径。
• 编译阶段无报错、代码能正常识别DLL里的类和方法，仅代表VS在编译时能找到你配置的引用路径，和运行时的加载路径完全是两套逻辑。
• 你报错里缺失的Microsoft.SharePoint.Library, Version=15.0.0.0是SharePoint 2013的服务端专属程序集，本身依赖一堆SharePoint服务端的原生组件和注册表配置，不是单独拷一个DLL就能正常加载的。

1. 先修正DLL存放路径
   • 右键项目打开「属性」面板，依次进入「配置属性-常规」，查看输出目录的实际绝对路径，把所有和SharePoint相关的引用DLL（包括提示缺失的Microsoft.SharePoint.Library.dll）全部拷贝到这个输出目录下，和你生成的exe文件放在同一级。
   • 回到VS的解决方案资源管理器，找到你添加的Microsoft.SharePoint引用，右键打开属性面板，把「复制本地」选项设置为True。这个配置正常会让VS生成时自动拷贝DLL到输出目录，但C++ CLR项目经常出现这个配置不生效的情况，第一次配置完建议手动去输出目录确认DLL确实存在。
2. 确认运行环境匹配
   • 15.0版本的服务端SharePoint程序集只能在已经安装了SharePoint Server 2013的64位服务器上正常运行。如果你是在本地开发机（没有安装SharePoint服务端）调试，哪怕把所有DLL都拷全，也会因为缺原生依赖、服务端配置缺失报加载错误。这种场景要么直接到对应SharePoint服务器上做调试，要么换用SharePoint客户端对象模型（CSOM）的独立客户端DLL开发，不需要依赖服务端安装环境。
3. 修正平台目标配置
   • 打开项目属性面板，依次进入「配置属性-链接器-高级」，把目标计算机选项设置为x64。SharePoint 2013是纯64位程序，如果你把项目目标平台设成x86或者Any CPU，也会触发“找不到DLL”的误导性报错。
4. 以上操作都无效时，用官方工具定位具体加载失败原因
   • 打开VS2019对应的开发者命令提示符，输入fuslogvw回车打开程序集绑定日志查看器，开启绑定失败日志记录后复现报错，就能直接看到程序运行时到底在哪些路径搜索DLL、具体缺哪个依赖项，不用盲目猜路径问题。

注意：不要尝试从非SharePoint服务器上单独拷贝这个DLL到开发机用，微软官方不支持这种部署方式，大概率会出现权限、依赖缺失的各类异常问题。

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