Google Cloud Discovery Engine自定义数组字段过滤结果不稳定问题咨询

1. 自定义数组字段过滤的已知一致性问题 #

目前官方未公开标注自定义数组字段过滤存在一致性问题，但从你遇到的随机失败情况推测，大概率是分布式索引分片的同步延迟导致。Discovery Engine采用多分片索引架构，文档重新导入或索引更新后，各分片间的同步可能存在时间差，部分查询请求会路由到未完成同步的分片，从而触发字段不支持的错误。

2. 字段名称或值的隐藏约束 #

• 字段名称：避免使用可能与内部保留关键字冲突的命名，requiredPermissions虽不在公开保留列表中，但部分隐性关键字可能引发解析异常；另外，字段名包含大写字母可能在部分分片的解析逻辑中存在兼容问题，建议尝试改为全小写required_permissions测试。
• 字段值：确认值中无特殊字符（如冒号、未转义引号）及不可见字符（如空格、换行符），这类内容可能导致部分分片解析字段时出现异常。

3. 查看Discovery Engine实际识别的内容 #

• 执行gcloud discovery-engine indexes describe命令，查看索引元数据，确认schema配置已正确应用到索引实例。
• 用gcloud discovery-engine documents list列出已索引文档，随机选取部分执行gcloud discovery-engine documents get命令，验证字段是否存在且格式符合要求。
• 开启查询日志，通过Cloud Logging查看每次查询的路由信息和分片响应，定位失败请求对应的分片状态。

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