4. 图数据库环境搭建：以Neo4j为例的安装、配置、启动与基本操作

在反欺诈图谱回放链路中，Neo4j 是承载实体关系存储与实时查询的核心引擎。本节将带领你完成从环境准备、安装配置到服务启动与基础操作的完整流程，确保后续链路搭建有一个稳定、可复现的图数据库底座。

4.1 环境准备与版本选择

Neo4j 提供社区版（Community Edition）和企业版（Enterprise Edition）。反欺诈原型开发与教学场景推荐使用社区版 4.x 或 5.x LTS 版本。以下为关键环境依赖：

4.2 安装方式对比

Neo4j 支持多种安装方式，不同场景推荐不同路径：

4.3 安装步骤（Linux tar.gz 方式）

以下步骤以 Ubuntu 22.04 + Neo4j 4.4.35 社区版为例：

1. 下载并解压

   wget https://dist.neo4j.org/neo4j-community-4.4.35-unix.tar.gz
   tar -xzf neo4j-community-4.4.35-unix.tar.gz
   sudo mv neo4j-community-4.4.35 /opt/neo4j

2. 配置环境变量（编辑 ~/.bashrc 或 /etc/profile）

   export NEO4J_HOME=/opt/neo4j
   export PATH=$PATH:$NEO4J_HOME/bin

   执行 source ~/.bashrc 使其生效。
3. 验证 JDK 版本

   java -version
   # 必须输出 OpenJDK 11 或 17，否则需先安装对应 JDK

4. 调整文件句柄限制（Linux 必须操作）

   # 编辑 /etc/security/limits.conf，添加：
   neo4j   soft   nofile   40000
   neo4j   hard   nofile   60000

4.4 核心配置参数

配置文件位于 $NEO4J_HOME/conf/neo4j.conf。以下是与反欺诈图谱回放链路最相关的配置项：

4.5 启动与停止服务

Neo4j 提供 neo4j 命令行工具管理服务生命周期：

# 首次启动示例
cd /opt/neo4j
./bin/neo4j start

# 查看启动日志
tail -f /var/log/neo4j/neo4j.log
# 看到 "Started." 字样表示启动成功

# 浏览器访问
# http://localhost:7474
# 默认用户名/密码：neo4j/neo4j，首次登录会强制修改密码

4.6 基本操作：Cypher 入门

启动成功后，通过 Neo4j Browser 或 cypher-shell 执行以下基础操作，验证数据库可用性：

# 通过 cypher-shell 执行批量操作示例
cypher-shell -u neo4j -p your_password

# 创建反欺诈图谱中的典型实体
CREATE (d:Device {device_id:'DEV001', fingerprint:'abc123', ip:'192.168.1.1'})
CREATE (a:Account {account_no:'6222021234567890', bank:'ICBC'})
CREATE (p:Person {name:'王五', phone:'13800138000'})
CREATE (p)-[:OWNS]->(a)
CREATE (a)-[:LOGIN_FROM]->(d);

4.7 反欺诈图谱环境验证流程

以下 SVG 展示了从环境搭建到基本操作验证的完整链路，帮助你确认图数据库已就绪：

4.8 常见问题与排查

4.9 本章小结

完成本节内容后，你应具备以下能力：

• 在 Linux 环境中通过 tar.gz 方式独立安装 Neo4j 社区版
• 根据反欺诈场景需求调整核心内存与网络配置
• 使用 neo4j 命令启动、停止、重启服务，并通过日志定位启动故障
• 通过 Cypher 创建节点、关系、索引，并执行基础路径查询
• 掌握反欺诈图谱环境搭建的常见问题排查方法