VS开发Outlook插件安装报System.Data.SQLite.dll哈希与清单不符错误

问题本质 #

该错误是ClickOnce安装器做文件完整性校验时触发的：实际读取到的System.Data.SQLite.dll计算出的哈希值，和发布阶段写入VSTO程序清单里记录的哈希值不匹配，通常由文件被篡改、发布时拉取错误版本dll、清单生成异常三类原因导致。

排查步骤 #

• 检查项目编译输出目录（bin文件夹）下的System.Data.SQLite.dll，确认文件版本、大小和项目中引用的版本完全一致，排查是否存在杀毒软件实时扫描篡改dll、云同步工具锁定/修改文件的情况
• 检查项目发布配置：右键VSTO项目→【属性】→【发布】选项卡→打开【应用程序文件】面板，确认System.Data.SQLite.dll的发布状态为「包含（自动）」，且源路径指向当前项目编译输出的对应dll，没有指向旧版本文件路径
• 检查发布包目录，确认没有手动替换过目录内的System.Data.SQLite.dll，没有历史版本发布的残留文件

解决方法 #

按以下顺序操作即可覆盖绝大多数场景：

1. 全量清理重编译
   关闭所有Visual Studio窗口，手动删除项目根目录下的bin、obj两个文件夹，重新打开项目后先右键解决方案执行【还原NuGet包】，再选择【重新生成解决方案】，重新走发布流程生成全新安装包，不要复用之前生成的旧安装包测试。
2. 修正SQLite引用配置
   如果是通过NuGet引入的System.Data.SQLite，先卸载所有SQLite相关NuGet包（包括System.Data.SQLite.Core、System.Data.SQLite.Linq等依赖项），重新安装和项目目标.NET框架版本、平台目标（x86/x64/Any CPU）完全匹配的版本；如果是本地手动引入的dll，右键该dll引用打开属性面板，将「复制本地」设为True，「特定版本」设为True，避免编译时拉取其他路径下的同名dll。
3. 排除外部篡改干扰
   将项目的编译目录、发布输出目录加入本地杀毒软件、终端安全管理软件的白名单，暂时关闭OneDrive、企业云盘等文件同步工具对这两个目录的实时同步，避免编译、发布过程中dll被锁定、注入内容导致哈希变化。
4. 手动重算更新清单哈希
   如果以上操作都无效，可以用Visual Studio自带的Mage清单编辑工具手动重新计算所有文件的哈希并更新清单：
   • 打开对应版本的Visual Studio开发人员命令提示符，切换到发布包目录下Application Files/[你的插件名_版本号]的子文件夹
   • 执行以下命令更新应用程序清单的哈希值，如果你给插件配置了代码签名证书，补上证书路径和密码参数，没有配置的话可以省略：

     mage -u OutlookAddin.dll.manifest -CertFile "你的签名证书.pfx路径" -Password "证书密码"
     

   • 再执行命令更新外层.vsto部署清单的引用，确保它关联到刚更新的应用程序清单：

     mage -u ../../OutlookAddin.vsto -AppManifest "OutlookAddin.dll.manifest" -CertFile "你的签名证书.pfx路径" -Password "证书密码"
     

提示：如果开发时没有配置代码签名证书，安装插件时需要先把插件发布者的证书加入本地「受信任的发布者」存储，否则会触发不受信任的安装拦截。

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