Neptune引擎升级至1.1.1后Gremlin查询触发InternalFailureException咨询

近期我们已将Neptune引擎升级至1.1.1（R7）版本，同时将Gremlin升级至3.5.3版本。

升级后遇到以下错误：

2023-03-02T11:50:01.184Z    d44416f3-82d5-4030-88f6-383d33860d7f    INFO    ERROR ResponseError: Server error: {
    "detailedMessage": "Exception processing a script on request [RequestMessage{, requestId=478e7350-3f1a-4ff3-8415-c996160d6c5f, op='bytecode', processor='traversal', args={gremlin=[[], [V(), hasLabel(person), has(objId, ******@gmail.com), outE(employer), has(app, FP), order(), by(timestamp, null), as(e), inV(), as(v), select(v), by([[], [valueMap()]])]], aliases={g=g}}}].",
    "requestId": "478e7350-3f1a-4ff3-8415-c996160d6c5f",
    "code": "InternalFailureException"
} (500)
    at Connection._handleMessage (/var/task/node_modules/gremlin/lib/driver/connection.js:316:9)
    at WebSocket.<anonymous> (/var/task/node_modules/gremlin/lib/driver/connection.js:131:43)
    at WebSocket.emit (node:events:513:28)
    at WebSocket.emit (node:domain:489:12)
    at Receiver.receiverOnMessage (/var/task/node_modules/ws/lib/websocket.js:789:20)
    at Receiver.emit (node:events:513:28)
    at Receiver.emit (node:domain:489:12)
    at Receiver.dataMessage (/var/task/node_modules/ws/lib/receiver.js:413:14)
    at /var/task/node_modules/ws/lib/receiver.js:379:23
    at /var/task/node_modules/ws/lib/permessage-deflate.js:298:9 {
  statusCode: 500,
  statusMessage: `{"detailedMessage":"Exception processing a script on request [RequestMessage{, requestId=478e7350-3f1a-4ff3-8415-c996160d6c5f, op='bytecode', processor='traversal', args={gremlin=[[], [V(), hasLabel(person), has(objId, ******@gmail.com), outE(employer), has(app, FP), order(), by(timestamp, null), as(e), inV(), as(v), select(v), by([[], [valueMap()]])]], aliases={g=g}}}].","requestId":"478e7350-3f1a-4ff3-8415-c996160d6c5f","code":"InternalFailureException"}`,
  statusAttributes: Map(0) {}
}

我们使用的查询语句如下：

query=g.V().hasLabel(type).range(startIndex,endIndex).valueMap();

升级后该查询无法正常执行，请问升级后是否需要对查询语句进行调整？

回答 #

1. 调整valueMap()的行为
   Gremlin 3.5.x中valueMap()默认返回List类型的属性值，若你的代码依赖旧版本单值返回逻辑，可改为valueMap(true)来保留单值格式（仅适用于单值属性），或在业务代码中处理List结果。

2. 校验range()参数合法性
   确保startIndex从0开始，且endIndex大于startIndex，同时不超出结果集范围。Neptune 1.1.1对参数校验更严格，非法参数易触发内部错误。

3. 检查变量绑定逻辑
   确认type、startIndex、endIndex等变量已正确绑定到查询中，避免因变量未解析导致语法异常。Gremlin 3.5对变量绑定的规范要求更严格。

4. 修正错误日志中的查询写法
   错误日志里的查询包含order().by(timestamp, null)，这种写法在Gremlin 3.5中不被支持，需明确指定排序方向，比如order().by('timestamp', desc)或order().by('timestamp', asc)。

若调整后仍出现InternalFailureException，建议开启Neptune查询日志获取详细堆栈信息，进一步定位问题。

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