使用Azure AI Search Python SDK无法向ComplexField添加数据的问题

你在定义ComplexField时设置了collection=True，这意味着payload字段被定义为复杂对象的集合（数组），但你上传的文档中payload是单个字典，不符合索引定义的类型要求，因此被识别为空值，触发了非空校验错误。

有两种修复方式，根据你的实际需求选择：

方案1：修改索引定义，适配单个嵌套字典 #

如果你的业务场景中payload是单个嵌套对象，而非数组，只需移除ComplexField中的collection=True参数：

ComplexField(
    name="payload",
    fields=[
        SimpleField(name="processId", type=SearchFieldDataType.String),
        SimpleField(name="color", type=SearchFieldDataType.String),
    ],
    # 移除collection=True，将字段定义为单个复杂对象
)

修改后重新创建索引，再上传原有的request_example文档即可正常识别。

方案2：修改文档结构，适配集合类型的复杂字段 #

如果你确实需要payload作为复杂对象的集合，需将上传文档中的payload改成数组格式，即使只有一个元素也要用数组包裹：

request_example = {
    "id": "1",
    "text": "bla",
    "payload": [
        {
            "processId": "00665",
            "color": "green"
        }
    ]
}

保持原索引定义不变，上传修改后的文档即可符合要求。

• 当设置collection=True时，Azure AI Search要求字段值必须是数组结构，单个对象会被判定为空；
• 若无需集合类型，务必不要添加collection=True参数，避免类型不匹配问题。

内容的提问来源于stack exchange，提问作者Irina Kärkkäinen