Apache Ignite缓存存在数据但SQL查询返回0记录问题求助

• 优先核查自定义实体类的SQL注解配置
  你建表时指定了VALUE_TYPE为com.abc.entities.trade.TradeStatsEntity、KEY_TYPE为com.abc.entities.trade.TradeStatsEntityKey，所有和表字段对应的属性必须添加@QuerySqlField注解，且注解的name属性、字段类型必须和DDL中的定义完全一致。如果清空数据后更新过实体类代码，存在注解漏加、字段名/类型修改后未同步DDL的情况，写入缓存的数据不会进入SQL索引，就会出现SQL查询返回空的问题。
• 排查序列化配置一致性
  集群所有节点、写入数据的应用端必须统一使用BinaryMarshaller，且序列化相关配置（如compactFooter开关、类元数据注册策略）完全一致。如果序列化规则不匹配，SQL引擎无法正常解析缓存中的二进制数据，会直接跳过对应记录。你可以通过Ignite Visor执行cache scan TradeStatsCache命令验证，如果能扫描到全量键值对但SQL无返回，即可定位为序列化或注解配置问题。
• 确认查询时的schema匹配
  你创建的表归属PRODSCHEMA，查询时要么带上schema前缀（select * from PRODSCHEMA.TRADESTATS），要么先切换当前会话的schema为PRODSCHEMA再执行查询。在sqlline工具中可先执行!schema查看当前默认schema，再执行SET SCHEMA PRODSCHEMA后重试查询，排除schema选错的低级错误。
• 验证写入逻辑和schema定义的匹配度
  应用通过缓存API写入数据时，put操作的键必须是TradeStatsEntityKey的实例、值必须是TradeStatsEntity的实例，不能使用BinaryObject等其他类型作为键值，也不能出现键字段类型和DDL主键定义不匹配的情况，否则SQL引擎会将这些记录识别为非法数据不纳入查询范围。
• 快速验证手段
  你可以直接通过SQL插入一条测试数据：

insert into PRODSCHEMA.TRADESTATS values ('2024-01-01','TEST_TYPE','TEST_SUBTYPE','TEST_TRADE',10,2,8,CURRENT_TIMESTAMP);

插入后再执行查询，如果能查到这条SQL写入的记录、但查不到应用写入的记录，即可100%确认是应用写入的键值实体不符合SQL schema配置要求，和DDL定义不匹配。

• 残留元数据清理
  如果以上配置都核查无误，可尝试完全清理旧缓存元数据后重试：先停掉所有写入应用，删除TradeStatsCache缓存，再重新执行建表DDL，最后启动应用写入数据，避免旧的元数据残留导致SQL索引异常。

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