Gremlin为已有顶点新增/更新属性、创建边时异常问题

• 原有逻辑仅覆盖新建顶点的属性赋值：你在addV生成顶点的遍历链上追加了property()步骤，但是coalesce匹配到已存在顶点走unfold()分支时，没有任何属性更新逻辑，自然不会修改已存在顶点的属性。
• 报错直接原因：你在addSource遍历中追加的sideEffect(select(source.label).property(...))逻辑没有对应的步标签支撑——你从来没有通过as(source.label)给遍历中的顶点打对应别名，select会直接取当前遍历流中的对象，拿到TinkerVertex实例；后续在addE的执行链路中触发这段sideEffect时，遍历上下文已经切换，你尝试用Column.keys读取键值时，实际传入的是Vertex对象（Vertex不是Map结构，不支持按键访问），最终抛出异常。

核心错误原文翻译：传入的对象不支持按键访问，对象类型为org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerVertex

核心思路是把属性赋值逻辑从新建顶点的分支里抽出来，统一在coalesce拿到顶点实例（无论新建还是已存在）之后执行，同时删掉无效的跨上下文select逻辑。

修复后的JS版本代码 #

// 仅定义新建顶点的基础逻辑，不在这个阶段处理动态属性、不追加无效sideEffect
const addSource = this.__.addV(source.label)
  .property(GREMLIN_ID, source.id)
  .property("created_timestamp", new Date().getTime());

const addDestination = this.__.addV(destination.label)
  .property(GREMLIN_ID, destination.id)
  .property("created_timestamp", new Date().getTime());

// 先构建基础遍历流
let traversal = this.client.getTraversal()
  // 处理目标顶点upsert
  .V(destination.id)
  .fold()
  .coalesce(this.__.unfold(), addDestination);
// 给目标顶点追加所有属性（无论新旧顶点都会执行更新）
for (const [key, value] of Object.entries(destination.properties)) {
  traversal = traversal.property(key, value);
}
// 存储目标顶点后继续处理源顶点
traversal = traversal.store("destination")
  .V(source.id)
  .fold()
  .coalesce(this.__.unfold(), addSource);
// 给源顶点追加所有属性（无论新旧顶点都会执行更新）
for (const [key, value] of Object.entries(source.properties)) {
  traversal = traversal.property(key, value);
}
// 存储源顶点后处理边upsert
traversal = traversal.store("source")
  .outE(association)
  .where(this.__.inV().hasId(destination.id))
  .fold()
  .coalesce(
    this.__.unfold(), 
    this.__.addE(association).from(this.__.V(source.id)).to(this.__.V(destination.id))
  )
  .store("association")
  .select("source", "destination", "association");

const v = await traversal.next();
console.log(v.value.get("source"));
console.log(v.value.get("destination"));   
return {
  source: v.value.get("source"),
  destination: v.value.get("destination"),
  association: v.value.get("association"),
};

复现用例的修复版Gremlin查询 #

l = [[origin:'usa'], [origin:'ind']]

g.inject(l).
 unfold().as('properties').
  V('1669333c-8ed1-4955-bacb-2c2e8ef7bfa5').
  fold().
  coalesce(unfold(), addV('test').property(id, '1669333c-8ed1-4955-bacb-2c2e8ef7bfa5')).
  sideEffect(
    select('properties').unfold().as('kv').
    property(select('kv').by(Column.keys), select('kv').by(Column.values))
  ).
  addE("ANONYMOUS").
  to(
    V('00000000000000000000000000000000').
    fold().
    coalesce(unfold(), addV('test').property(id, '00000000000000000000000000000000')).
    sideEffect(
      inject(l).unfold().as('properties1').
      unfold().as('kv1').
      property(select('kv1').by(Column.keys), select('kv1').by(Column.values))
    )
  )

• Gremlin的property(key, value)步骤本身自带upsert能力：只要遍历器当前指向已存在的顶点/边，调用该步骤会自动更新属性值，属性不存在则新增，不需要额外包裹sideEffect。
• addE().to(__.xxx())这类内部的匿名遍历是独立上下文，外层通过as()打的步标签不会透传进来，禁止在匿名遍历内select外层的步标签。
• 做顶点+边的级联upsert时，属性赋值逻辑必须写在coalesce外层，也就是拿到确定的顶点实例之后再执行，才能同时覆盖新建、已存在两种场景，不要把属性赋值全塞在addV的分支里。

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