XC1020报错：已存在evohtmltopdf.dll但XAML MSBuild构建失败如何解决？

错误 XC1020: XAML MSBuild任务发生构建错误:“未能加载文件或程序集“file:///C:\Projects\DIB\IB\Dev\MAIN\Source\Business\VBMService\bin\evohtmltopdf.dll”或它的某一个依赖项。清单中不存在的模块已流入。(异常来自 HRESULT:0x80131043)”

问题产生原因 #

• 架构不匹配：evohtmltopdf.dll属于非托管原生dll，32位和64位版本不能通用。如果项目构建的目标平台（x86/x64/Any CPU）和dll的架构不一致，MSBuild会因为匹配失败无法加载。
• 依赖组件缺失：evohtmltopdf依赖对应版本的Microsoft Visual C++ Redistributable运行时库，构建环境没有安装对应版本的运行时，会触发依赖加载失败。
• 程序集匹配校验失败：dll本身存在损坏、版本和项目引用声明的版本不匹配，会导致程序集清单校验不通过，触发该报错。
• 项目引用配置错误：dll未正确添加到项目引用，或者文件属性的「复制到输出目录」未正确配置，MSBuild加载时路径解析失败。
• 权限不足：MSBuild进程没有bin目录的读取、执行权限，即使文件物理存在也无法加载。

排查解决步骤 #

• 校验架构匹配：右键项目→「属性」→「生成」，确认目标平台和你使用的evohtmltopdf.dll架构一致。如果使用64位版本dll，目标平台选择x64，取消勾选「首选32位」选项。
• 安装VC运行时：根据evohtmltopdf的版本要求，安装对应架构（x86/x64）的Microsoft Visual C Redistributable运行时库，推荐优先安装2015-2022兼容版运行时。
• 修正项目引用配置：
  1. 右键项目→「引用」，找到evohtmltopdf对应的引用项，右键属性将「复制本地」设置为True，确认引用路径指向dll的实际存放路径。
  2. 如果是直接将dll放到项目目录中，右键项目内的dll文件→「属性」，将「复制到输出目录」设置为如果较新则复制。
• 校验dll完整性：重新获取对应版本的evohtmltopdf.dll替换现有文件，排除文件损坏、版本不匹配的问题。
• 权限验证：关闭Visual Studio，右键图标选择「以管理员身份运行」，重新加载项目后执行构建，排除权限不足问题。
• 清理重建：右键解决方案→「清理解决方案」，手动删除项目根目录下的bin、obj文件夹，再重新执行生成操作，清除旧缓存文件的干扰。

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