升级Apache Gremlin至3.6.3/3.6.4后方法签名缺失异常如何解决？

问题场景 #

项目在Apache Gremlin 3.6.2版本下运行正常，升级至3.6.3或3.6.4版本后单元测试失败，抛出groovy.lang.MissingMethodException，核心报错信息如下：

groovy.lang.MissingMethodException: No signature of method: org.apache.tinkerpop.gremlin.process.traversal.Operator$8.call() is applicable for argument types: (org.apache.tinkerpop.gremlin.process.traversal.dsl.graph.DefaultGraphTraversal...) values: [[HasStep([effectiveDate.lte(Wed Sep 13 14:34:56 IDT 2023)])], ...]
Possible solutions: wait(), name(), any(), values(), find(), dump()

对应的Gremlin查询语句：

g.V('89885718930341148618906941499288497180')
  .outE('related-account')
  .or(
    and(has('effectiveDate', lte(datetime('2023-09-13T11:34:56.951Z'))), has('expirationDate', gte(datetime('2023-09-13T11:34:56.951Z')))),
    and(has('effectiveDate', lte(datetime('2023-09-13T11:34:56.951Z'))), hasNot('expirationDate'))
  )
  .project('effectiveDate', 'expirationDate', 'accountId', 'relationTypeCd', 'status')
  .by('effectiveDate')
  .by(coalesce(values('expirationDate'),constant(null)))
  .by(inV().coalesce(values('accountId'),constant(null)))
  .by('relationTypeCd')
  .by(coalesce(values('status'),constant(null)))
  .limit(10)

解决方案 #

1. 修正逻辑步骤的参数传递方式 #

Gremlin 3.6.3版本对and()/or()的参数处理进行了严格化，要求必须传递Traversal实例而非直接的Step集合。需要用闭包{}包裹每个逻辑分支的条件：

修正后的查询：

g.V('89885718930341148618906941499288497180')
  .outE('related-account')
  .or(
    // 用闭包包裹第一个and条件链
    {has('effectiveDate', lte(datetime('2023-09-13T11:34:56.951Z'))).has('expirationDate', gte(datetime('2023-09-13T11:34:56.951Z')))},
    // 用闭包包裹第二个and条件链
    {has('effectiveDate', lte(datetime('2023-09-13T11:34:56.951Z'))).hasNot('expirationDate')}
  )
  .project('effectiveDate', 'expirationDate', 'accountId', 'relationTypeCd', 'status')
  .by('effectiveDate')
  .by(coalesce(values('expirationDate'),constant(null)))
  .by(inV().coalesce(values('accountId'),constant(null)))
  .by('relationTypeCd')
  .by(coalesce(values('status'),constant(null)))
  .limit(10)

也可以保留and()显式调用，同样用闭包包裹：

.or(
  {and(has('effectiveDate', lte(datetime('2023-09-13T11:34:56.951Z'))), has('expirationDate', gte(datetime('2023-09-13T11:34:56.951Z'))))},
  {and(has('effectiveDate', lte(datetime('2023-09-13T11:34:56.951Z'))), hasNot('expirationDate'))}
)

2. 统一Gremlin依赖版本 #

确保项目中所有Gremlin相关依赖（gremlin-core、gremlin-groovy、gremlin-driver等）都同步升级到3.6.3或3.6.4，避免版本不一致导致的方法签名不兼容问题。

问题原因 #

Gremlin 3.6.3版本调整了逻辑步骤（and/or）的参数解析逻辑，取消了Groovy隐式将Step数组转换为Traversal的兼容处理，要求必须明确传递Traversal实例，闭包包裹是Groovy环境下生成Traversal的标准方式。

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