VS2017含托管C++库的C#项目x64调试报Missing Method Exception

已确认的故障现象 #

• 当前处于x64调试配置下，已在托管C例程代码处设置断点，且对应生成的C DLL、PDB文件均为最新版本，仍无法跳转进入C++代码执行，调试输出提示：

  Breakpoint is set !!!
  The C ++ dll and pdb files are up to date!
  

• 在C++类库中新增的测试方法，通过对象浏览工具可正常识别显示，但运行时调用该方法会触发Missing Method Exception
• 相同项目在原VS2010开发环境下可正常运行；切换到x86配置时无上述所有异常
• 人工交叉核对x64与x86配置的项目参数，未发现可见的设置差异

根因定位与解决步骤 #

• 核查托管C项目x64配置下的托管导出规则
  从VS2012开始，MSVC编译器对x64平台下的托管代码导出、名字修饰规则与VS2010存在兼容性差异：老项目中常用于区分导出的条件编译宏，很可能在x64配置下触发了非预期的预处理器分支，导致本该对C#层可见的托管方法，被编译成了非托管导出符号、或是直接被裁剪出托管元数据。
  具体操作：检查新增方法所在类的修饰符，确认是public可访问的ref类成员；核对C项目属性中「公共语言运行时支持」的选项，确保x64配置下的/clr参数和x86配置完全一致，避免出现x64下误用/clr:netmodule、/clr:pure等和x86不一致的编译选项。
• 核查调试过程中实际加载的二进制与符号路径
  不要仅凭DLL、PDB的文件时间戳判断是否为最新版本，需在调试状态下打开「模块」窗口，定位对应C++生成的托管DLL：
  1. 确认实际加载的DLL文件路径、目标平台标识为x64，排除因目录探测顺序问题，加载了同路径下残留的x86版本同名DLL的情况
  2. 核对该DLL关联加载的PDB文件路径，确认调试器加载的符号和当前实际加载的DLL版本匹配，避免因符号缓存目录指向老版本PDB，导致断点无法命中。
• 针对Missing Method Exception的专项排查
  该异常在托管混合编程场景下，基本由运行时加载的程序集和引用的程序集不匹配导致：对象浏览器的方法识别结果可能来自源码目录下残留的旧版本DLL，并非运行时实际加载的文件。触发异常时可直接查看异常详情中的程序集加载路径，确认实际加载的C++类库DLL是否为最新编译版本——很多迁移后的项目会将所有平台的输出统一指向同一个输出目录，x86编译生成的旧版本DLL很容易覆盖x64新生成的DLL，就会出现对象浏览器能看到新方法、实际运行加载老版本DLL报找不到方法的问题。
• 额外注意项
  VS2010编译器生成的托管C程序集，和VS2012及以上版本编译器生成的托管元数据存在二进制兼容性差异，需确认C#主项目的引用路径，是否指向了迁移后新编译的x64版本C类库，而非一直引用着VS2010时期留存的旧版二进制文件，这类错位会刚好表现为x86配置正常、x64配置异常的特征。

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