Neo4j配置唯一约束时如何实现批量插入更新非唯一属性

你的MERGE写法存在逻辑问题：把name、accession、definition三个属性全作为节点匹配条件，但你给Term标签加的唯一约束仅作用在accession属性上。
当数据库中已经存在相同accession的Term节点，但它的name或者definition取值和当前传入行不一致时，MERGE会判定“未匹配到现有节点”，转而尝试创建新节点。此时新节点的accession和已有节点重复，直接触发唯一约束校验失败，就会抛出你看到的节点已存在错误。

MERGE匹配节点时，必须仅将带唯一约束的属性作为匹配键，匹配到节点后再单独SET更新其余非键属性；如果未匹配到现有节点，MERGE会自动创建带该唯一键的节点，后续SET逻辑会同步生效，不需要额外编写新建分支逻辑。
修改后的批量写入Cypher语句如下：

UNWIND $rows AS row
MERGE (t:Term {accession: row.accession})
SET t.name = row.name,
    t.definition = row.definition
RETURN count(*) AS total

如果你需要区分“节点首次创建”和“节点已存在更新”两种场景做额外处理（比如打操作时间戳），可以拆分两个SET子句分别对应处理：

UNWIND $rows AS row
MERGE (t:Term {accession: row.accession})
// 仅节点第一次创建时执行
ON CREATE SET 
    t.name = row.name,
    t.definition = row.definition,
    t.created_at = datetime()
// 匹配到已有节点时执行
ON MATCH SET
    t.name = row.name,
    t.definition = row.definition,
    t.updated_at = datetime()
RETURN count(*) AS total

• 单批次传入的$rows条数建议控制在1000~10000区间，根据服务端内存配置调整，单批次事务过大会引发内存溢出或者事务超时
• 大批量导入前建议先删除Term标签上除accession唯一约束之外的其他二级索引，等数据全部导入完成后再重建，可明显提升写入速度
• 每个批次传入的数据提前在业务层按accession去重，避免同个事务内多次操作同一个节点引发不必要的锁冲突

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