简介

关于本指南

保持 Neo4j 部署处于最新状态，可确保您获得性能、安全性和错误修复方面的最新改进。

谁应该阅读本指南？

本升级与迁移指南专为希望升级或迁移自托管 Neo4j 部署的资深系统管理员和运维工程师编写。

如果您使用的是 Neo4j Aura，则无需进行升级或迁移，因为该服务始终保持最新状态。但是，如果您希望从 Aura 4.4 迁移到最新版本，从自托管 Neo4j 迁移到 Aura，或者从 Aura Free 迁移到其他套餐，可以参考以下教程：

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

准备工作

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

升级/迁移过程。
与其他系统的兼容性。

版本号

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

Neo4j 服务器版本控制
引入于 2025.01

日历版本控制 (CalVer) 格式为 YYYY.MM.PATCH，基于发布的年份和月份，例如 2025.01、2025.02 等。补丁编号在同月的每次发布中递增。

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

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

Neo4j 4 和 5 版本控制

Neo4j 4 和 5 版本使用语义版本控制 (SemVer)。Neo4j 版本号采用 MAJOR.MINOR.PATCH 的格式。

MAJOR（主版本）引入了重大的架构改进和功能。它们与之前的 MAJOR 版本不兼容。与数据库交互的系统可能需要更新。
MINOR（次版本）引入了改进和新功能。它们与同一 MAJOR 版本下的其他 MINOR 版本向后兼容。
PATCH（补丁版本）修复了关键错误和安全问题。它们是向后兼容的，并替换同一 MAJOR.MINOR 版本的先前版本。

Neo4j 4.4 和 5.26 被指定为 LTS 版本。LTS 版本拥有三年的支持窗口，在此期间它们会接收关键补丁和安全更新，但不会获得新功能或改进。Neo4j 4.4 的长期支持已于 2025 年 11 月 30 日结束。Neo4j 5 将获得支持直至 2028 年 11 月。

Cypher 版本
引入于 2025.06

从 Neo4j 2025.06 开始，Cypher^® 语言已从 Neo4j 服务器解耦，并遵循其自身的版本控制。您可以选择 Cypher 5 或 Cypher 25。

您可以通过为整个 DBMS 配置默认 Cypher 版本、为每个数据库配置，或在每个查询级别设置它来指定 Cypher 的版本。

将默认语言设置为 CYPHER 5 可确保在该数据库上运行的所有查询都将使用 Neo4j 2025.06 版本发布时所具备的 Cypher 5 版本（除非您在查询前加上 CYPHER 25，这会覆盖此默认设置）。2025.06 版本之后引入的任何更改都不会影响查询的语义。

将默认语言设置为 CYPHER 25 可确保在该数据库上运行的所有查询都将使用该数据库当前运行的 Cypher 25 版本（除非您在查询前加上 CYPHER 5，这将覆盖此默认值）。例如，具有默认语言 Cypher 25 的 Neo4j 2025.08 数据库将使用 Neo4j 2025.08 中存在的 Cypher 25，包括在 Neo4j 2025.06、2025.07 和 2025.08 中引入的所有更改。

有关更多信息，请参阅《操作手册》→ 配置 Cypher 默认版本以及《Cypher 手册》→ 选择 Cypher 版本。

下表概述了在未明确设置 DBMS 级别（使用 db.query.default_language）的情况下，不同升级或安装场景中分配给数据库的 Cypher 版本。

表 1. 不同场景下的默认 Cypher 版本
场景	现有数据库	新数据库
全新安装	不适用	默认为 Cypher 5
升级	Cypher 5	默认为 Cypher 5
升级	Cypher 25	默认为 Cypher 5

停机时间

当配置为集群时，Neo4j 可以在不停机的情况下进行升级，Neo4j 4.4 到 Neo4j 5.26 除外。支持从 Neo4j 5.26 LTS 在线升级到任何 Neo4j 2025-2026 版本。

独立版 Neo4j 的升级始终需要停机。

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

存储格式

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

Neo4j 4.4 和任何 Neo4j 2025-2026 版本之间的存储格式没有变化。但是，Neo4j 5.16 中引入的 block 格式是企业版从 Neo4j 5.22 开始新建数据库的默认存储格式，也是 5.26 及更高版本中所有数据库的默认格式。High_limit 和 standard 格式已在 5.23 中弃用，并计划在 2026 LTS 之后移除。

降级

Neo4j 不支持降级。如果升级或迁移不成功，您必须进行完整回滚，包括还原升级前或迁移前的备份。

继续阅读

如果您处于 Neo4j 2025-2026 版本，或者希望将数据库从 Neo4j 5 升级，请继续阅读 Neo4j 2025-2026 部分。

如果您处于 Neo4j 5，或者希望将数据库从 4.4 迁移，请继续阅读 Neo4j 5 部分。

如果您要升级到 Neo4j 4 的某个版本，请阅读 Neo4j 4 部分。

简介