如何正确投影valueMap()列表并解决AWS Neptune空键序列化异常

报错根因 #

'{"requestId":"9dfb90b3-e479-43b1-a77b-826d71575e78","code":"InternalFailureException","detailedMessage":"Error during serialization: Null key for a Map not allowed in JSON (use a converting NullKeySerializer?) (through reference chain: java.util.ArrayList[0]->java.util.LinkedHashMap["grandchild"])"}'

该报错为AWS Neptune的序列化规则限制导致：Gremlify使用的原生TinkerPop序列化逻辑允许Map使用null作为键，但Neptune底层使用Jackson实现JSON序列化，默认禁止null作为Map的键，因此在Gremlify可正常运行的逻辑迁移到Neptune后触发异常。

可行解决方案 #

方案1：替换分组的null键为非空默认值（最推荐） #

你当前使用null作为分组键的逻辑只需要替换为任意非空字符串作为固定键即可，无需修改其他核心逻辑：
原写法示例（触发报错）：

g.V().hasId('目标顶点ID')
  .group().by(constant(null))
  .by(project('prop1','prop2').by('属性1').by(values('多值属性').fold()))

修改后写法：

g.V().hasId('目标顶点ID')
  .group().by(constant("result")) // 将null替换为非空字符串作为键
  .by(project('prop1','prop2').by('属性1').by(values('多值属性').fold()))

方案2：查询后过滤移除null键 #

如果需要保留原有分组逻辑，可以在查询末尾新增步骤过滤null键的条目：

// 原有查询逻辑后新增以下步骤
.unfold().filter(keys.is(neq(null))).group().by(keys).by(values)

方案3：替代null分组实现顶点强制返回 #

如果使用null分组的目的是保证单个顶点必然返回结果，可替换为以下逻辑，完全规避null键的产生：

g.V().hasId('目标顶点ID')
  .project('prop1','prop2').by('属性1').by(values('多值属性').fold())
  .fold().coalesce(unfold(), constant([:])) // 无匹配时返回空Map，保证返回结构稳定

多值属性投影注意事项 #

处理多值属性时统一使用values('属性名').fold()将属性值打包为数组返回，避免单值/多值场景返回结构不一致导致的后续解析异常。

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