JanusGraph 0.5.3版本hasLabel查询结果与label()返回值不匹配问题

问题原因 #

• 版本已知缺陷：JanusGraph 0.5.3存在顶点标签元数据缓存不一致问题，当图的元数据（如新增、修改标签）更新后，部分实例的本地缓存未同步最新的标签ID映射，hasLabel()判断时会用缓存的旧ID做匹配，导致符合条件的顶点被错误过滤。
• 复合索引存储异常：如果为eventid属性和顶点标签建立了复合索引，写入eventid=3bbe顶点时，索引层存储的标签ID出现序列化错误。hasLabel()查询会优先走索引过滤，直接排除了该顶点；而label()步骤是直接读取顶点存储层的标签值，不受索引数据异常影响，所以返回结果正常。
• HBase序列化偏移：0.5.3版本对HBase后端的顶点行键序列化存在极小概率的偏移问题，导致标签字段的存储位置在索引层和顶点存储层不对应，过滤时匹配失败。

修复方案 #

临时修复 #

• 执行图实例的元数据缓存刷新，在Gremlin控制台运行JanusGraphManagement.clearCache()，强制所有实例同步最新的元数据映射，执行后再重试查询验证。
• 针对异常顶点执行一次轻量更新操作，比如给顶点新增一个临时属性后再删除，触发索引数据重写，修复索引层的标签ID异常。
• 重启所有JanusGraph实例，清空本地缓存，重新加载全量元数据。

永久修复 #

• 升级JanusGraph版本到0.6.4及以上，该版本已经修复了元数据缓存同步、HBase序列化相关的多个已知问题，不会再出现同类查询不一致的情况。
• 如果暂时无法升级，可关闭本地元数据缓存，在配置文件中添加cache.db-cache = false即可，缺点是会带来一定的查询性能下降。

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