如何在BizTalk Server 2016中手动部署DLL及应用？

核心原因说明 #

直接复制DLL到应用资源路径无效，是因为BizTalk应用的组件依赖GAC注册和管理数据库资源关联，而非单纯的文件替换，同时宿主实例会缓存已加载的程序集，必须重启才能加载新版本。

具体操作步骤 #

1. 准备编译产物
   在开发机通过VS2015编译.csproj和.btproj项目，获取带有强名称的目标DLL文件（此前正常部署的项目已配置强签名，确保编译时未修改该配置）。

2. 将DLL注册到服务器GAC
   以管理员身份打开命令提示符，使用gacutil.exe完成注册：

   gacutil /i "C:\Temp\YourBizTalkAssembly.dll"
   

   注：gacutil.exe通常位于C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools目录下，需根据服务器安装的.NET版本调整路径。

3. 更新BizTalk应用的资源关联

   • 打开BizTalk Server管理控制台，定位到目标应用；
   • 右键点击应用 → 资源 → 添加 → 资源；
   • 在弹窗中选择资源类型为程序集，浏览到刚注册的DLL（或本地路径的DLL文件），勾选覆盖现有资源，点击确定完成关联更新。

4. 重启BizTalk宿主实例

   • 在管理控制台的平台设置 → 宿主实例中，找到运行该应用的宿主实例（如默认的BizTalkServerApplication）；
   • 右键点击实例 → 重启，等待实例重新启动完成。

5. 验证部署效果

   • 查看目标应用的资源列表，确认程序集版本已更新；
   • 触发对应的业务流程或端口测试，验证DLL的变更逻辑已生效。

关键注意事项 #

• 若DLL版本号变更，需确保BizTalk业务流程、映射等artifacts对该组件的引用版本同步匹配；
• 若应用涉及多个宿主实例，需全部重启以确保所有节点加载新版本DLL；
• 操作前建议备份BizTalk管理数据库，避免误操作导致的应用异常；
• 对于包含BizTalk特定artifacts（映射、管道、业务流程）的.btproj编译DLL，上述步骤同样适用，因为这些artifacts的元数据存储在BizTalk管理数据库中，必须通过资源更新完成同步。

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