如何避免BizTalk 2013/R2 WCF-WebHttp REST发送端口因HTTP 400挂起

我来帮你拆解这个问题——这确实是BizTalk集成REST服务时非常常见的痛点，很多开发者都踩过这个坑。你遇到的核心问题是：业务流程Scope捕获的是逻辑层面的异常，但WCF传输层的错误（比如HTTP 400这类）默认会绕过流程处理直接让发送端口挂起。下面给你梳理几种可行的解决方法，以及行业内通用的最佳实践：

一、先搞懂为什么捕获了Exception还会挂起 #

BizTalk的异常处理分为两层：

• 业务流程的Scope.Exception：只处理流程内部逻辑抛出的异常（比如消息映射错误、自定义业务规则异常）。
• WCF传输层异常：像HTTP 400/401/500这类错误属于传输层面的问题，默认会触发发送端口的挂起机制，因为BizTalk认为这是“无法自动恢复的传输故障”。

二、具体解决方法 #

1. 直接配置WCF-WebHttp发送端口的错误处理属性 #

这是最快的解决方式，不需要写代码：

• 打开发送端口属性，切换到「WCF-WebHttp Transport」选项卡，找到「Error Handling」区域：
  • 勾选Suppress transport exceptions：这个选项会把传输层异常转化为消息上下文的错误属性，而不是直接挂起端口。之后你可以在业务流程里读取这些属性来处理错误。
  • 调整「Retry count」为0（针对HTTP 400这类客户端错误，重试没有意义），如果是5xx服务器错误，可以适当设置重试次数。

2. 自定义WCF行为处理传输错误 #

如果需要更灵活的错误转化逻辑，可以写一个自定义WCF行为：

• 实现IErrorHandler接口，捕获传输层异常并转化为BizTalk可处理的消息，阻止端口挂起。示例代码如下：

  public class RestErrorHandler : IErrorHandler
  {
      // 标记错误已处理，避免端口挂起
      public bool HandleError(Exception error) => true;
  
      public void ProvideFault(Exception error, MessageVersion version, ref Message fault)
      {
          if (error is WebException webEx)
          {
              if (webEx.Response is HttpWebResponse httpResp)
              {
                  // 构造自定义错误消息，包含HTTP状态码和描述
                  var errorContent = new
                  {
                      StatusCode = (int)httpResp.StatusCode,
                      StatusDesc = httpResp.StatusDescription,
                      ErrorDetail = new StreamReader(httpResp.GetResponseStream()).ReadToEnd()
                  };
                  fault = Message.CreateMessage(version, "", errorContent);
              }
          }
      }
  }
  

• 把这个行为注册到BizTalk的WCF配置中，绑定到你的发送端口上，这样所有传输错误都会被转化为常规消息，业务流程可以正常接收处理。

3. 完善业务流程的错误处理逻辑 #

光靠传输层配置还不够，还要在流程里做针对性处理：

• 为发送端口的操作配置故障消息类型，然后在流程里添加「Catch Fault」分支，专门处理WCF返回的故障消息。
• 读取上下文属性：通过WCF.HttpStatusCode属性判断错误类型（比如400是客户端错误，401是权限问题），然后做对应的处理（比如记录日志、通知运维、丢弃消息）。

三、行业通用的最佳实践 #

大多数BizTalk开发者都会结合以下方式来处理这类问题：

• 区分错误类型处理：客户端错误（4xx）直接记录并通知，服务器错误（5xx）配置有限次数重试后转入错误队列。
• 启用失败消息路由：在发送端口属性里勾选「Enable failed message routing」，把无法处理的错误消息路由到BizTalk内置的错误队列，避免端口挂起。
• 统一日志记录：把所有异常（流程逻辑+传输层）都记录到BizTalk Tracking或自定义日志系统，方便后续排查问题。

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