使用REST API更新BizTalk 2020发送端口跟踪设置遇报错求助

算力阿峰

2026-7-4

BizTalk 2020 REST API 更新发送端口时触发“Adapter is not a valid adapter”错误的处理方案

这大概率是BizTalk 2020 REST API的设计缺陷——按REST规范，GET获取的资源 payload 直接PUT回去应该保持状态一致，但发送端口的PUT接口存在字段默认值处理疏漏。
临时解决步骤：
1. 从GET请求返回的JSON中，显式保留AdapterName字段（即使值和原有配置完全一致），不能依赖接口自动填充。比如你的PUT payload必须包含：
```
{
  "Name": "portname",
  "AdapterName": "你的发送端口适配器名称（如WCF-BasicHttp）",
  // 其他从GET获取的所有字段（包括AdapterConfig等）
}
```
2. 检查AdapterConfig字段：确保这个XML格式的字符串在PUT时没有被转义错误或截断，接口对该字段的完整性要求极高，细微格式问题都可能触发异常。
Bug确认：该问题并非个案，不少BizTalk 2020用户反馈过类似情况，属于管理REST API在发送端口PUT处理上的疏漏。你可通过微软官方支持渠道提交反馈，但目前只能通过显式传递Adapter相关字段规避问题。