简介

关于本指南

保持您的 Neo4j 部署始终最新，可以确保您获得最新的性能改进、安全补丁和错误修复。

谁应该阅读本指南？

本升级和迁移指南是为希望升级或迁移自管理 Neo4j 部署的经验丰富的系统管理员和运维工程师编写的。

如果您正在使用 Neo4j Aura，则无需升级或迁移，因为该服务始终是最新版本。但是，如果您想从 Aura 4.4 迁移到 5、从自管理 Neo4j 迁移到 Aura，或者从 Aura Free 迁移到其他计划，您可以参考以下教程：

本页在介绍特定版本页面之前，先介绍了一些重要的 Neo4j 概念。

准备工作是任何成功升级或迁移的关键。在对生产 DBMS 进行更改之前，强烈建议使用测试环境来检查：

从 2025 年 1 月起，Neo4j 服务器采用了日历版本控制 (CalVer)。早期版本，例如 Neo4j 4 和 5，使用语义版本控制 (SemVer)。Neo4j 的完全托管云服务 Neo4j Aura 仅使用最新版本。

CalVer 版本控制格式 YYYY.MM.PATCH 基于发布年份和月份，例如 2025.01、2025.02 等。补丁号在同一月份内的每次发布都会递增。

CalVer 版本可选地包含第四个组件 LTS。这表示该版本为长期支持 (LTS) 版本。Neo4j 大约每 18 到 24 个月会发布一个新的 LTS 版本。LTS 版本有三年的支持期，在此期间它们会收到关键补丁和安全更新，但不会有新功能或改进。

在 LTS 发布后的紧接着的版本中，可能会移除一些已弃用的功能，软件要求和默认配置可能会更改。因此，在跨越 LTS 版本的升级时必须谨慎。LTS 版本被视为检查点，在升级过程中，Neo4j 服务器必须升级到当前版本和目标版本之间的每个 LTS 版本/检查点。

Neo4j 4 和 5 版本使用语义版本控制 (SemVer)。Neo4j 版本号遵循 MAJOR.MINOR.PATCH 模式。

Neo4j 4.4 和 5.26 被指定为 LTS 版本。LTS 版本有三年的支持期，在此期间它们会收到关键补丁和安全更新，但不会有新功能或改进。Neo4j 4.4 将支持到 2025 年 11 月，Neo4j 5 将支持到 2028 年 11 月。

当配置为集群时，Neo4j 可以无停机升级，但 Neo4j 4.4 到 Neo4j 5 的升级除外。支持从 Neo4j 5 LTS 到 Neo4j 2025.x 的在线升级。

独立 Neo4j 升级时总是需要停机。

服务器通过更新其二进制文件并重启来升级。当您从 Neo4j 4.4 迁移到 Neo4j 5 时，您必须将数据库从旧服务器迁移到新服务器。

存储格式更新是可选的，除非您要迁移到不再支持旧存储格式的版本。有关每个 Neo4j 版本可用存储格式的更多信息，请参阅操作手册 → 存储格式。

Neo4j 4.4 和 2025.x 之间存储格式没有变化。然而，在 Neo4j 5.16 中引入的 block 格式是企业版的首选存储格式。High_limit 和 standard 已被弃用，并计划在 2026.LTS 之后移除。

Neo4j 不支持降级。如果升级或迁移不成功，您必须执行完全回滚，包括恢复升级前或迁移前的备份。

如果您正在使用 Neo4j 2025 或想从 5 迁移数据库，您可以前往Neo4j 2025 部分。

如果您正在使用 Neo4j 5 或想从 4.4 迁移数据库，您可以前往Neo4j 5 部分。

如果您正在升级到 Neo4j 4 的版本，请阅读Neo4j 4 部分。