BizTalk 2020使用HTTPAdapter时BtsHttpReceive.dll报错如何解决

外层节点产生原因 #

上游Web API将XML内容以字符串类型进行WCF序列化时，会自动包裹http://schemas.microsoft.com/2003/10/Serialization/#string命名空间的根节点，同时将内部XML的特殊字符转义为实体编码，导致默认XMLReceive管道的XML disassembler无法匹配到你部署的Select结构Schema，抛出找不到文档规范的错误。

常见疑问解答 #

不需要在发起请求前主动添加该节点，该节点是上游序列化的非预期产物，主动添加反而需要额外处理内部内容转义逻辑，属于冗余操作。

问题修复方案 #

优先方案（无自定义开发成本） #

修改上游Web API返回逻辑，直接返回application/xml类型的原生XML结构，不将XML内容作为字符串序列化，即可避免外层string节点的生成，BizTalk默认XMLReceive管道可直接解析匹配已部署的Schema。

兼容方案（无法修改上游逻辑时使用） #

针对你已经实现自定义管道移除string节点后出现的500错误，按以下步骤排查修复：

• 确认自定义管道组件的执行阶段：移除string节点、还原内部XML转义字符的逻辑必须放在管道的解码阶段，早于XML disassembler执行，避免反汇编阶段结构校验失败。
• 修正消息上下文属性：
  • 保留消息原生的所有HTTP相关上下文属性，不要清除InboundHeaders、HttpVerb等系统内置属性
  • 显式给修改后的消息设置MessageType上下文属性，值为http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/MainData#Select，匹配已部署的Schema
  • 将消息BodyPart的ContentType属性设置为application/xml
• 补全管道组件异常处理：给自定义管道组件添加全局异常捕获逻辑，将异常信息写入Windows事件日志，未捕获的组件异常会直接导致HTTP适配器返回500错误。
• 校验HTTP适配器配置：如果是请求-响应模式的接收端口，需勾选返回相关的响应消息选项，同时确认业务流程的响应消息已正确关联到接收端口的响应链路，无响应输出也会触发500错误。

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