AWS Amplify中GraphQL数值过滤问题的解决方案

问题背景

在使用AWS Amplify的GraphQL API进行数据查询时，开发者可能会遇到数值过滤条件失效的问题，特别是当涉及负数值比较时。本文将以地理位置坐标(lat/lng)过滤为例，详细分析问题原因并提供解决方案。

问题现象

开发者尝试通过GraphQL API查询特定经纬度范围内的数据时，发现：

1. 当经度(lng)为负值时，过滤条件不生效
2. 当使用between操作符时，如果最小值大于最大值，会触发DynamoDB异常
3. 即使明确指定eq条件，也无法返回预期结果

根本原因分析

经过排查，发现问题的核心在于GraphQL模型定义不当：

1. 数据类型错误：开发者将经纬度字段(lat/lng)定义为String类型，而非数值类型(Float/Int)
2. 字符串比较问题：DynamoDB对字符串类型的数值比较会按字典序进行，导致负值比较结果不符合数学逻辑
3. 范围查询限制：between操作要求上限值必须大于或等于下限值，否则会抛出异常

解决方案

1. 修正数据类型定义

正确的模型定义应使用Float类型：

type Affiliate @model @searchable {
  id: ID!
  name: String!
  lat: Float!
  lng: Float!
}

2. 数据迁移注意事项

修改数据类型后，需要确保：

• 数据库中的现有数据已正确转换为数值类型
• 新写入的数据必须为数值类型
• 客户端查询时传递数值而非字符串

3. 查询优化建议

对于地理位置查询这类常见场景，建议：

1. 使用适当的数据结构：考虑使用Geo库或专门的地理空间索引
2. 避免全表扫描：为常用查询条件创建二级索引
3. 合理设置查询限制：避免一次性获取过多数据

性能优化补充

针对地理位置查询的特殊性，开发者还可以考虑：

1. 使用Geohash：将二维坐标转换为一维字符串，便于范围查询
2. 分区策略：按地理区域划分数据，减少查询范围
3. 缓存机制：对热点区域查询结果进行缓存

总结

AWS Amplify的GraphQL API在使用数值过滤时，必须确保：

• 正确定义字段数据类型
• 理解DynamoDB的查询限制
• 针对特定场景优化查询结构

通过正确使用Float类型和优化查询策略，可以有效解决地理位置数据过滤问题，提升应用性能。