必须主动设置内存环境变量：NEO4J_dbms_memory_heap_initial__size=2g、NEO4J_dbms_memory_heap_max__size=2g、NEO4J_dbms_memory_pagecache_size=4g，并挂载数据卷与指定社区版镜像neo4j:5.22.0-community，避免使用latest标签。

用Docker部署Neo4j并配置内存，关键在于启动时正确设置环境变量和挂载配置文件，而不是依赖默认参数。官方镜像虽开箱即用，但默认内存配置（如堆内存仅512MB）在中等规模数据下容易触发GC或查询超时，必须主动调整。

拉取合适版本的镜像

避免使用latest标签，防止版本不一致导致行为差异或兼容问题：

• 推荐使用带-community后缀的LTS版本，例如neo4j:5.22.0-community（截至2026年3月发布的最新社区版）
• 执行命令：docker pull neo4j:5.22.0-community
• 验证是否拉取成功：docker images | grep neo4j

启动容器并设置基础内存参数

Neo4j 5.x 版本起，内存配置主要通过环境变量控制，无需手动修改neo4j.conf即可生效：

Docker Compose Optimizer

优化 Docker Compose 配置，适用于开发和生产环境——审计服务、网络、卷、健康检查和资源管理。

下载

• NEO4J_dbms_memory_heap_initial__size：初始堆大小，建议设为2g
• NEO4J_dbms_memory_heap_max__size：最大堆大小，与上一项保持一致更稳定
• NEO4J_dbms_memory_pagecache_size：页缓存大小，建议设为物理内存的50%～75%，例如4g
• 完整示例命令：

docker run -d \ --name neo4j-prod \ -p 7474:7474 -p 7687:7687 \ -v $HOME/neo4j/data:/data \ -v $HOME/neo4j/import:/import \ -v $HOME/neo4j/logs:/logs \ -e NEO4J_AUTH=neo4j/mySecurePass123 \ -e NEO4J_ACCEPT_LICENSE_AGREEMENT=yes \ -e NEO4J_dbms_memory_heap_initial__size=2g \ -e NEO4J_dbms_memory_heap_max__size=2g \ -e NEO4J_dbms_memory_pagecache_size=4g \ neo4j:5.22.0-community

进阶：挂载自定义配置文件（可选）

当需要启用APOC、调整日志级别或开启远程访问时，建议挂载conf目录并编辑neo4j.conf：

• 先运行一次容器生成默认配置：docker run --rm -v $HOME/neo4j/conf:/conf neo4j:5.22.0-community
• 编辑$HOME/neo4j/conf/neo4j.conf，取消注释并修改以下行：

# dbms.memory.heap.initial_size=2g
# dbms.memory.heap.max_size=2g
# dbms.memory.pagecache.size=4g
# dbms.connector.bolt.advertised_address=0.0.0.0:7687

再启动时挂载该目录：-v $HOME/neo4j/conf:/conf，配置即生效。

验证内存配置是否生效

容器启动后，进入容器检查实际加载的配置：

• docker exec -it neo4j-prod bash
• 执行：cat /var/lib/neo4j/conf/neo4j.conf | grep memory
• 或直接查看JVM启动参数：ps aux | grep java | grep -o 'Xmx[^ ]*'，应显示Xmx2g
• 登录http://localhost:7474，执行:sysinfo命令，可在“JVM Memory”区域确认堆与页缓存值