当前弃用内容

本节列出了所有已弃用的 Neo4j 服务器功能，并在适用时提供了替代方案。弃用的功能仅在长期支持 (LTS) 版本发布后才会立即移除。

有关 Cypher 语言的弃用信息，请参阅 Cypher 手册 → 弃用、添加和兼容性。

操作系统

Neo4j 2026.01

  • CentOS Stream 8.x。
    该操作系统将与 2026 年发布的下一个 LTS 版本一起继续获得支持，但在 2026 LTS 之后的新版本将不再支持该平台。建议在下一个 LTS 版本发布之前升级到受支持的操作系统版本。

  • Neo4j Linux 发行版中的 System V (SysV) init 脚本。
    SysV init 脚本位于 /etc/rc.d/init.d/ 或 /etc/init.d 中。目前所有受支持的 Linux 发行版默认使用 systemd，而不是 SysV init 脚本。

Neo4j 2025.10

以下 Linux 发行版已被弃用：

  • Red Hat Enterprise Linux 8.x

  • Debian 11.x

  • Windows Server 2022

  • MacOS 13 Ventura

  • MacOS 14 Sonoma

    这些操作系统将与 2026 年发布的下一个 LTS 版本一起继续获得支持，但在 2026 LTS 之后的新版本将不再支持这些平台。建议在下一个 LTS 版本发布之前升级到受支持的操作系统版本。

过程 (Procedures)

查看所有已弃用的过程
名称 社区版 企业版 注释

dbms.cluster.recreateDatabase()

在 2025.04 中弃用
由 dbms.recreateDatabase() 替代

dbms.quarantineDatabase() 仅限管理员

在 2025.01 中弃用
在 Cypher 25 中移除
由 dbms.unquarantineDatabase() 替代

db.index.vector.createNodeIndex()

在 5.26 版本中已弃用
在 Cypher 25 中移除
由 Cypher 命令 CREATE VECTOR INDEX 替代。有关详细信息，请参阅 Cypher 手册 → 创建向量索引。

dbms.cluster.uncordonServer()

5.23 版本弃用.
在 Cypher 25 中移除
在 Neo4j 5.23 之前，该过程只能以管理员权限运行。
由 ENABLE SERVER 替代。

dbms.cluster.routing.getRoutingTable()

在 5.21 中弃用.
由以下内容替代：dbms.routing.getRoutingTable()。

cdc.current() Beta 测试版

在 5.17 中弃用
由以下内容替代：db.cdc.current()

cdc.earliest() Beta 测试版

在 5.17 中弃用
由以下内容替代：db.cdc.earliest()

cdc.query() Beta 测试版 仅限管理员

在 5.17 中弃用
由以下内容替代：db.cdc.query()

db.create.setVectorProperty() Beta 测试版

在 5.13 中弃用
在 Cypher 25 中移除
由以下内容替代：db.create.setNodeVectorProperty()

dbms.upgrade() 仅限管理员

在 5.9 中弃用
在 Cypher 25 中移除

dbms.upgradeStatus() 仅限管理员

在 5.9 中弃用
在 Cypher 25 中移除

dbms.cluster.readReplicaToggle() 仅限管理员

在 5.6 中弃用
在 Cypher 25 中移除
由以下内容替代：dbms.cluster.secondaryReplicationDisable()。

配置设置

查看所有已弃用的配置设置
名称 社区版 企业版 注释

dbms.routing.load_balancing.plugin

在 2025.05 中弃用

server.db.query_cache_size

已在 5.7 中弃用

dbms.security.oidc.<provider>.auth_params

动态 已弃用

dbms.security.oidc.<provider>.client_id

动态 已弃用

指标 (Metrics)

查看所有已弃用的指标 (Metrics)
名称 注释

<prefix>.cluster.raft.tx_retries 在 2025.02 中弃用

该指标将在未来的版本中移除。

数据库数据指标 在 5.15 中弃用

<prefix>.ids_in_use.relationship_type

<prefix>.ids_in_use.property

<prefix>.ids_in_use.relationship

如果您需要粗略估算图数据库的大小，请改用 <prefix>.neo4j.count.relationship。

<prefix>.ids_in_use.node

如果您需要粗略估算图数据库的大小，请改用 <prefix>.neo4j.count.node。

日志记录

Neo4j 2025.05

JSON 格式查询日志中的 failureReason 列已被弃用，建议使用 errorInfo 列。有关详细信息，请参阅 日志记录 → 查询日志的 JSON 格式日志条目。

Neo4j-admin 工具

查看所有已弃用的命令
名称 社区版 企业版 注释

neo4-admin database aggregate-backup

在 2025.01 中弃用
由 neo4j-admin backup aggregate 替代
查看所有已弃用的命令选项
命令 选项 注释

neo4-admin database migrate

--page-cache 在 2025.04 中弃用

该选项已弃用，由 --max-off-heap-memory 选项替代。

种子提供程序 (Seed providers)

Neo4j 5.26

S3SeedProvider 已由 CloudSeedProvider 替代。有关详细信息，请参阅 从 URI 播种 (Seed from URI)。

Java API

Neo4j 5.26

服务端通知 API 和 Result Core API 的 getNotifications() 方法已弃用。

Neo4j 错误代码消息

Neo4j 2025.04

以编程方式使用错误消息已被弃用。由于错误消息可能会在未来版本中更改，请在应用程序代码中解析或使用 GQLSTATUS 错误代码。有关详细信息，请参阅 错误和通知的状态代码 → GQLSTATUS 错误代码列表。