如何从正常Gremlin遍历创建匿名遍历？

核心概念澄清 #

• 遍历源g：是连接具体图实例的查询入口，绑定了图的配置与上下文，所有独立执行的Gremlin查询必须从g开始。
• 匿名遍历__：是构建子遍历片段的工具，本身不绑定任何图实例，必须嵌套在g启动的主遍历中才能生效，执行时会继承主遍历的上下文（比如当前遍历到的顶点/边）。

报错原因 #

你遇到的报错The child traversal of [GraphStep(vertex,[2509])] was not spawned anonymously，本质是在需要子遍历的位置误用了遍历源g。比如你可能把g.V().hasLabel(...)作为子遍历嵌套到了where()、match()这类需要子遍历的步骤里，而TinkerPop 3.5+版本对这种场景做了严格检查，禁止用g作为子遍历的起始。

注意：如果是单独执行g.V().hasLabel('User').has('userid', 'xxx')这个查询，在TinkerPop 3.7.3里是完全合法的，不会报错。你说这个查询在其他数据库正常、TinkerPop报错，大概率是你的代码里把这段查询当成了子遍历在使用（比如嵌套到了另一个遍历中），或者客户端的调用方式有误。

为什么__.V()单独执行没结果 #

__是匿名遍历构造器，它创建的遍历片段没有绑定任何图实例，相当于只是一段"查询模板"，没有入口去访问图数据。必须把它嵌套在g启动的主遍历里才能生效，比如：

// 正确的嵌套使用场景：用__作为子遍历筛选当前顶点的关联元素
g.V().where(__.hasLabel('User').has('userid', '917ca68e-f931-4dc4-9bf4-53d86c620eb4'))

解决方案 #

1. 独立查询场景：坚持用g作为查询起始，比如你的原查询：

   g.V().hasLabel('User').has('userid', '917ca68e-f931-4dc4-9bf4-53d86c620eb4')
   

   如果执行这个仍报错，检查你的代码是否把它当成了子遍历嵌套，或者客户端是否错误地将查询作为子遍历发送（比如Node.js客户端调用方法有误）。
2. 子遍历嵌套场景：在需要子遍历的位置（如where()、union()、match()等），用__开头构建子遍历片段，示例：

   // 查找关联到指定User的顶点
   g.V().out().where(__.hasLabel('User').has('userid', '917ca68e-f931-4dc4-9bf4-53d86c620eb4'))
   

排查建议 #

• 检查代码逻辑，确认查询是作为独立查询执行，还是作为子遍历嵌套使用。
• 验证本地TinkerPop Docker镜像的配置：确保g是正确初始化的遍历源，绑定了你的图实例。
• 对比其他数据库的代码：确认在TinkerPop中是否用了相同的调用方式（比如Node.js客户端中是否正确调用next()或toList()执行查询）。

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