BizTalk2020升级项目部署报错：文件非有效BizTalk程序集

核心原因 #

这个错误是BizTalk低版本项目跨大版本升级时的典型问题：部署失败的均为System.Biztalk.BiztalkAssembly类型的编排/映射项目，普通System.Biztalk.Assembly类库项目不受影响，本质是老项目配置残留了BizTalk 2006版本的构建元数据，加上BTDF 5.8初始版本对BizTalk 2020的路径解析兼容问题，导致BTSTask在加载程序集时无法正确解析依赖路径。

修复步骤 #

• 修复项目文件残留配置
  卸载出问题的编排项目，用文本编辑器打开对应的.csproj文件：
  1. 检查所有Import节点和Reference节点，删除所有指向BizTalk 2006旧安装路径的配置，所有BizTalk专有程序集（Microsoft.XLANGs.BaseTypes、Microsoft.BizTalk.Pipeline、Microsoft.BizTalk.Orchestrations等）的HintPath统一替换为BizTalk 2020默认安装路径C:\Program Files (x86)\Microsoft BizTalk Server\2020\下的对应位置，确认引用的程序集版本与GAC中注册的BizTalk 2020版本（3.13.x.x）一致
  2. 检查<ProjectTypeGuids>节点，删除所有旧版本BizTalk的项目标识GUID，保留BizTalk 2020编排项目对应的正确GUID{EF10F166-AB27-4f4d-9E98-A5B6677D5FF8}即可
• 修复BTDF部署配置兼容问题
  打开Deployment.btdfproj文件：
  1. 确认<BizTalkVersion>节点的值配置为2020，不要残留旧版本号配置
  2. 检查所有资源包含节点的路径配置，确认没有引用编译输出目录外的旧版本dll，避免BTDF打包时拉取到不存在的历史版本文件
  3. 确认本地安装的BTDF 5.8是支持BizTalk 2020的后续构建版本，5.8初始版本存在BizTalkAssembly类型资源加载时的临时路径拼接bug，会直接触发“系统找不到指定路径”的错误
• 清理缓存后验证
  1. 关闭所有Visual Studio实例，删除解决方案下所有项目的bin、obj目录，清空%temp%目录下的BizTalk临时编译文件
  2. 以管理员身份启动Visual Studio，重新编译整个解决方案，先单独对出问题的dll执行GAC注册，确认无异常
  3. 脱离BTDF手动执行BTSTask命令加载该dll，如果依然报错，用系统自带的Fuslogvw.exe（程序集绑定日志查看器）抓取绑定失败日志，定位具体缺失的依赖项即可

你之前完成的引用检查、临时目录权限配置、目标应用名配置都是正确的常规排查项，这类跨大版本升级的问题不会出现在这些通用配置项上，重点排查旧版本配置残留即可。

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