使用APOC迁移Neo4j数据库遇故障：apoc.import.json失效及关系导入困惑

1. 迁移Neo4j数据库的标准方法 #

以下是几种可靠的迁移方案：

• 官方dump/load工具（优先推荐）：这是Neo4j官方提供的最稳定的全量迁移方式，能完整保留索引、约束、数据结构及所有数据。
  • 导出命令：

    neo4j-admin dump --database=neo4j --to=neo4j_dump.dump
    

  • 导入命令（需先关闭目标Neo4j服务）：

    neo4j-admin load --database=neo4j --from=neo4j_dump.dump --force
    

  企业版还支持增量备份与恢复，适合频繁迁移场景。
• APOC JSON导出导入（修正参数后使用）：你之前的问题出在导出时未保留节点ID映射，正确导出命令需添加exportIds: true参数，确保导入时能匹配节点：

  CALL apoc.export.json.all("backup.json", {useTypes: true, exportIds: true})
  

  导入时若不想手动创建约束，可添加batchMode: "BATCH"参数自动处理ID匹配：

  CALL apoc.import.json("backup.json", {batchMode: "BATCH"})
  

• CSV批量导入：适合超大规模数据迁移，先通过APOC导出节点和关系为CSV：

  CALL apoc.export.csv.all("backup_nodes.csv,backup_rels.csv", {useTypes: true})
  

  再用Neo4j官方neo4j-admin import工具加载CSV文件，效率远高于单条数据插入。

2. 通过apoc.load.json同时创建节点和关系 #

可以实现，分两步执行即可：

第一步：创建节点并保留原ID映射 #

先导入所有节点，将导出文件中原节点的id（即导入时需要的neo4jImportId）存储为新节点的属性，用于后续关系匹配：

CALL apoc.load.json("backup.json") YIELD value
WHERE value.type = "node"
CALL apoc.create.node(value.labels, value.properties) YIELD node
SET node.neo4jImportId = value.id
RETURN count(node) AS nodesCreated

第二步：创建关系 #

根据关系记录中的start和end字段（对应原节点ID），匹配已创建的节点并生成关系：

CALL apoc.load.json("backup.json") YIELD value
WHERE value.type = "relationship"
MATCH (startNode) WHERE startNode.neo4jImportId = value.start
MATCH (endNode) WHERE endNode.neo4jImportId = value.end
CALL apoc.create.relationship(startNode, value.type, value.properties, endNode) YIELD rel
RETURN count(rel) AS relationshipsCreated

完成后若不需要保留neo4jImportId属性，可执行以下命令删除：

MATCH (n) REMOVE n.neo4jImportId

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