Azure-Samples/azure-search-openai-demo 项目中的文档上传问题分析与解决方案

在 Azure-Samples/azure-search-openai-demo 项目中，用户可能会遇到一个常见的文档上传问题，表现为系统无法识别文档中的嵌套属性'oids'。这个问题通常发生在启用上传功能后，但未正确配置索引的情况下。

当用户尝试上传PDF文档时，系统会经历以下处理流程：

1. 使用Azure Document Intelligence提取文本内容
2. 将文档分割成多个章节
3. 计算每个章节的嵌入向量
4. 尝试将处理后的内容更新到搜索索引中

在这个过程中，系统会抛出错误："Cannot find nested property 'oids' on the resource type 'search.documentFields'"。这个错误表明搜索索引中缺少必要的字段定义，导致无法正确处理文档的访问控制列表(ACL)信息。

问题的根本原因在于索引结构不完整。当启用上传功能时，系统需要索引中包含特定的字段来存储文档的访问控制信息和存储位置。如果这些字段不存在，上传过程就会失败。

解决方案分为两个关键步骤：

1. 首先需要更新索引结构，添加必要的字段定义。可以通过运行管理脚本实现：

python ./scripts/manageacl.py -v --acl-action enable_acls

2. 然后需要为现有文档更新存储URL信息，指向主Blob容器：

python ./scripts/manageacl.py -v --acl-action update_storage_urls --url <存储账户URL>

这个问题的出现通常是因为项目部署后新增了上传功能，但索引结构没有相应更新。在实际应用中，当对搜索服务功能进行扩展时，必须确保索引结构与新功能需求保持一致。

对于开发者来说，理解这个问题的解决过程有助于更好地设计Azure搜索服务的架构。特别是在实现文档管理和访问控制功能时，预先规划好索引结构可以避免类似问题的发生。同时，这也展示了Azure搜索服务中索引结构与应用功能紧密耦合的特点，任何功能变更都需要考虑对索引结构的影响。