Neo4j 2025-2026 系列中的变更

本节涵盖了自 5.26 LTS 版本以来,Neo4j 服务器功能在各个版本中的变更。

Cypher 默认版本

Neo4j 2026.02

从 Neo4j 2026.02 开始,分发的 neo4j.conf 明确设置了 db.query.default_language=CYPHER_25。因此,使用所提供配置文件的新部署,其新建数据库默认使用 Cypher 25。详细信息,请参阅 配置 Cypher 默认版本

Neo4j-admin 导入工具

neo4j-admin database import [full|incremental] 命令受以下变更影响:

Neo4j 2025.12

--bad-tolerance=<num> 选项的默认值从 1000 更改为 -1,表示不限制。详细信息,请参阅 导入

在线数据库备份

neo4j-admin database backup 命令受以下变更影响:

Neo4j 2025.10

--include-metadata=none|all|users[=user1,user2]|roles 选项已更改,允许在执行数据库备份时过滤用户。此前,如果您在 --include-metadata 中指定了 users,备份文件将包含创建可使用该数据库的用户及其角色分配的命令。从 2025.10 开始,您可以定义特定用户列表(例如 users=alice,bob,charlie),这意味着只有这些用户会被包含在备份中。详细信息,请参阅 备份在线数据库

数据库复制

neo4j-admin database copy 命令受以下变更影响:

Neo4j 2025.01

--from-pagecache=<size> 选项的功能已更改。
现在,您不再需要指定读取源时分配多少缓存,而是可以控制复制操作期间用于读写的堆外内存(off-heap memory)最大值。通过配置堆外内存值,您也可以影响缓存分配。
为反映此变更,该选项增加了一个新名称:--max-off-heap-memory=<size>
详细信息,请参阅 提高性能

Cypher Shell

详细信息,请参阅 Cypher Shell

Neo4j 2025.08

--history 选项新增了 disable 参数。

Neo4j 2025.06

--error-format 选项的默认值从 legacy 更改为 gql

Neo4j 2026.01

新增了 --debug 参数,作为 --log 选项的别名。

配置设置

Neo4j 2025.12

企业版 initial.server.allowed_databasesinitial.server.denied_databases 支持数据库名称模式(通配符),且最小长度要求从 3 降低至 1

Neo4j 2025.06

企业版 以下指标已从 server.metrics.filter 的默认值中移除:

  • cluster.internal.discovery.memberset.left

  • cluster.internal.discovery.crdt.gossip_id_data.size

  • cluster.internal.discovery.crdt.server_data.size

  • cluster.internal.discovery.crdt.database_data.size

  • cluster.internal.discovery.crdt.leader_data.size

  • cluster.internal.discovery.crdt.total_merge_operations

  • cluster.internal.discovery.crdt.total_update_operations

  • cluster.internal.discovery.gossip.incoming_queue_size

  • cluster.internal.discovery.gossip.total_received_data

  • cluster.internal.discovery.gossip.total_sent_data

  • cluster.internal.discovery.gossip.uncontactable_members_exist

Neo4j 2025.03

企业版 server.metrics.filter 的默认值已更改。

包含的 neo4j.count 指标类取代了已弃用的 ids_in_use 指标。
更多信息,请分别参阅 监控 → 指标参考 以及《数据库数据计数指标》和《数据库数据指标》表格。

SSL 框架

Neo4j 2025.10

Neo4j 移除了 Java 21 中使用不安全 CBC 算法的默认密码套件。

  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA256

  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256

    不过,您仍然可以通过显式指定配置并在设置中引用它们来使用这些套件。

过程(Procedures)

Neo4j 2025.12

Cypher 25

  • dbms.setDefaultAllocationNumbers() 过程增加了一个输入参数:propertyShardReplicas

  • dbms.showTopologyGraphConfig() 过程的返回结果中包含了 propertyShardReplicas