使用Amplify的@searchable指令，AppSync控制台搜索无数据返回

以下是排查和解决的具体步骤：

1. 确认@searchable关联资源部署完成 #

• 运行命令 amplify status，检查OpenSearch（原Elasticsearch）相关资源是否显示为Deployed状态，无报错信息。
• 如果状态异常或存在报错，重新执行 amplify push，确保所有资源部署成功，过程中留意控制台输出的错误提示。

2. 检查数据同步时机 #

• 若现有数据是在添加@searchable指令前插入的，这些历史数据不会自动同步到OpenSearch索引，只有指令添加后新增的数据才会被同步。
• 历史数据同步解决方案：
  • 临时方案：删除现有数据后重新添加，新数据会被触发器自动同步到索引。
  • 永久方案：通过AWS控制台将DynamoDB中的历史数据导出到S3，再导入到对应的OpenSearch索引；或编写Lambda函数批量同步历史数据。

3. 验证查询语法有效性 #

• 先尝试不带过滤条件的基础查询，确认索引是否存在数据：

  query MyQuery {
    searchCards {
      total
      items {
        name
        id
      }
    }
  }
  

• 如果基础查询能返回数据，再检查过滤条件的语法是否符合要求。ne操作符是支持的，但需保证字段类型匹配（比如name为字符串类型，过滤值也必须是字符串）。

4. 检查OpenSearch索引状态 #

• 登录AWS控制台，进入OpenSearch服务，找到对应环境下的索引（名称通常以card-开头加随机后缀）。
• 查看索引的文档计数，若计数为0，说明同步完全失败，需排查DynamoDB触发器：
  • 进入DynamoDB控制台，找到Card对应的表，查看触发器列表，确认存在用于同步到OpenSearch的Lambda触发器。若不存在，重新执行amplify push重建触发器。

5. 确认IAM权限配置 #

• 检查AppSync中OpenSearch数据源对应的IAM角色，确保该角色拥有es:Search、es:Read等必要权限。Amplify通常会自动配置，但如果权限缺失，可手动在IAM控制台给角色添加对应策略。

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