neo4j版本怎么升级迁移

Neo4j 的升级和迁移通常分为版本升级（同数据库升级）和数据迁移（跨环境 / 跨版本迁移）两种情况。下面我按常见场景 + 实操步骤给你讲清楚。

一、先确认升级路径（非常重要）

Neo4j 升级有版本限制：

• 小版本升级（如 4.4.0 → 4.4.25）
  ✅ 直接升级，无需 dump/load
• 主版本升级（如 3.5 → 4.x，4.4 → 5.x）
  ⚠️ 通常需要 逐步升级 或 dump/restore

官方支持的典型路径

3.5 → 4.4 → 5.x

❌ 不支持 3.5 直接到 5.x

二、升级前必须做的事

1️⃣ 备份数据（必做）

neo4j-admin dump --database=neo4j --to=/backup/neo4j.dump

2️⃣ 查看当前版本

neo4j version

3️⃣ 查看配置文件

重点关注：

• neo4j.conf
• 插件（APOC、GDS）
• 自定义存储路径

三、方式一：原地升级（小版本）

步骤（以 Linux 为例）

# 停止服务
neo4j stop

# 安装新版本（覆盖安装或包管理）
apt upgrade neo4j

# 启动
neo4j start

✅ Neo4j 会自动做 store migration

四、方式二：Dump / Load 升级（推荐跨大版本）

1️⃣ 旧版本导出

neo4j-admin dump \
  --database=neo4j \
  --to=/data/neo4j.dump

2️⃣ 安装新版本 Neo4j

（不要启动服务）

3️⃣ 导入数据

neo4j-admin load \
  --database=neo4j \
  --from=/data/neo4j.dump \
  --force

4️⃣ 启动

neo4j start

五、方式三：物理文件迁移（同版本）

适用于：

• 换服务器
• Docker ↔ 物理机

步骤

1. 停止 Neo4j
2. 拷贝目录：

   data/databases
   data/transactions
   conf/neo4j.conf
   

3. 新机器相同路径放置
4. 启动

⚠️ 版本必须一致

六、Docker 升级示例

docker run \
  -v $PWD/data:/data \
  -v $PWD/conf:/conf \
  neo4j:5.20

升级只需改镜像 tag：

neo4j:4.4 → neo4j:5.20

七、常见坑

❌ 直接替换 bin / lib 文件
❌ 跨两个主版本
❌ 忘了升级 APOC / GDS 插件
❌ 没停库就拷数据

八、我可以更具体地帮你

你可以告诉我：

1. 当前 Neo4j 版本
2. 目标版本
3. 部署方式（物理 / Docker / 云）
4. 数据量大小

我可以直接给你精确升级命令和顺序。