Azure Data Factory连接REST API时JSON反序列化报错求助

1. API返回JSON格式不匹配ADF预期 #

• 根节点不是数组且未指定JSON路径：ADF的REST/HTTP连接器默认认根节点是数组，如果API返回的是包着数组的对象（比如{"result": [{},{}]}），必须在数据集的JSON设置里指定JSON path为$..result（对应你的数组节点路径），不然ADF没法识别数据结构。
• 嵌套结构或特殊字段未处理：如果返回的JSON有多层嵌套、带非标准值（比如未转义的特殊字符、ADF不兼容的日期格式），得检查数据集的结构映射是否正确，或者在复制活动里加数据转换处理这些特殊字段。

2. 链接服务/数据集配置有误 #

• Base URL和资源路径重复：就算测试连接成功，要是把https://api.example.com/v1/items设成Base URL，又在数据集里加/items，最终请求URL就会错，返回的可能是404页面的HTML，被当成JSON解析就会报错。得保证Base URL是根路径（比如https://api.example.com/v1），数据集里填相对路径（比如/items）。
• 缺失必要请求头/参数：测试连接只验证连通性，但预览数据时需要正确的请求头（比如Accept: application/json）或查询参数，没配置的话API可能返回XML、纯文本这类非JSON内容，直接触发反序列化错误。去数据集的请求设置里检查有没有加必要的头信息。

3. API返回的JSON本身有语法问题 #

• 看起来格式正常的JSON，可能藏着隐性错误：比如末尾多了逗号、字符串没闭合、特殊字符没转义。把API返回的内容复制到本地JSON校验工具里验证下，确认有没有语法问题。

4. 连接器版本兼容性问题 #

• 旧版本的REST/HTTP连接器对某些JSON格式支持有限，试试在链接服务的连接器版本里切换到最新版（如果有选项），重新配置数据集后再预览。

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