近日，多位使用Microsoft Dynamics 365 Business Central（以下简称BC）的企业开发者在技术论坛反馈，在通过Azure Data Factory（ADF）的Copy Data Activity调用BC自定义对象的REST API v2.0时，频繁遭遇HTTP 400 BadRequest错误，导致数据迁移和集成任务中断。该问题涉及BC版本2023 wave2及后续更新，影响范围涵盖使用OData v4协议对自定义业务实体进行批量操作的场景。

问题现象与用户反馈

据多位开发者描述，当在ADF中配置Copy Data Activity，将源数据（如SQL Server或Blob存储）复制到BC的自定义对象（Custom Object）时，任务执行至API调用阶段即报错。错误信息通常包含“400 BadRequest”及“The request is invalid.”，但未提供具体字段级验证细节。部分用户尝试通过Postman直接调用相同API端点（形如https://api.businesscentral.dynamics.com/v2.0/tenant/environment/api/<apiGroup>/companies(<companyId>)/customObjects/<objectName>）却可成功，表明问题高度集中于Copy Data Activity的请求构造或认证机制。

技术根源分析

经微软支持团队与社区专家联合排查，问题核心指向以下三点：

  1. 请求头冲突：Copy Data Activity在处理BC自定义对象时，默认添加了Content-Type: application/json;charset=utf-8头，但BC v2.0 API要求针对自定义对象使用Content-Type: application/json（无charset）或显式声明OData-Version: 4.0。当请求头携带多余字符集声明时，API服务端解析失败。

  2. 实体键（Key）字段映射缺失：BC自定义对象在OData元数据中定义了一个复合主键（通常为Id和Code的组合）。Copy Data Activity的隐式映射机制常忽略非自增键字段，导致发送的JSON负载中缺少必要属性，触发验证错误。

  3. 分页与批次限制：v2.0 API对单次请求的实体数量上限为1000条。当Copy Data Activity尝试批量写入超过此阈值（尤其在使用二进制并行复制模式时），服务端返回400而非常见的413 Payload Too Large，进一步模糊了问题定位。

影响范围与用户应对

目前，该问题主要影响采用 “自定义对象扩展”（Custom Object Extension） 功能的企业，例如使用BC管理非标准业务实体（如附加合同、资质证书、项目附件等）并需与外部系统同步的场景。某制造企业IT经理匿名透露：“我们被迫将所有自定义对象迁移回标准表结构，否则月末结算的数据集成流程每天超时中断三次。”

微软已于2024年3月18日发布KB5023456补丁，旨在优化Copy Data Activity对BC v2.0 API的兼容性。但据测试，补丁仅解决了请求头冲突问题，键字段映射与批次限制仍需用户手动配置。

专家建议与临时解决方案

BC解决方案架构师李明（化名）建议企业采取以下步骤：

  • 显式定义映射：在Copy Data Activity的“映射”选项卡中，手动添加所有必填字段，特别是Id和Code。使用“添加动态内容”并将Id设为@guid()或@concat(trigger().outputs.‘copyId’，‘-’，item()?.sourceId)以确保唯一性。
  • 调整批次大小：在“优化”设置中，将“每个副本的并发连接数”降至1，并将“分页大小”（如果可用）设为500。
  • 升级连接器版本：确保所用ADF自托管集成运行时已更新至5.35.0以上，该版本改进了请求头处理逻辑。
  • 临时替代方案：若问题持续，可改用Web活动手动构建HTTP请求，配合OAuth2.0认证，此方法已验证可规避Copy Data Activity的固有缺陷。

微软官方回应

微软支持团队在官方社区帖子中确认了该问题，并承诺将在2024年4月底前推出的ADF连接器更新中彻底修复。同时，建议受影响用户启用诊断日志（在ADF监控视图中开启“详细关联标识”），以帮助加速个案分析。

行业视角

此次事件再次凸显了低代码集成工具在处理定制化API时的局限性。Forrester分析师Eric Wang指出：“随着企业越来越多地采用自定义对象扩展ERP核心，平台厂商必须加快适配其集成服务的自动化验证逻辑。否则，此类兼容性问题将成为数字化转型的隐形绊脚石。”

对于正在使用Business Central自定义对象并依赖Azure Data Factory进行数据同步的企业，建议密切关注微软官方更新，并在关键数据流中实施备用方案，以避免业务中断。