一、前言
随着社交网络、电商推荐、金融风控以及物联网等行业的快速发展，现实世界中的实体之间往往存在着错综复杂的关联。传统的关系型数据库在处理这种多跳查询和深度关系分析时，性能往往会成为瓶颈。图数据库应运而生，它专为存储和计算海量关系数据而设计。本文将带你通过 Spring Boot 快速上手 Neo4j，完成一个完整的项目集成。
二、图数据库与 Neo4j 介绍
2.1 什么是图数据库
图数据库（Graph Database）不同于传统的行式存储或文档存储，它直接以节点（Node）、关系（Relationship）和属性（Property）来构建数据结构。这种模型天然契合现实世界的网状关系，在查询路径、社区发现等场景下具有显著优势。
2.2 Neo4j 是什么
Neo4j 是目前最流行的原生图数据库之一，支持 ACID 事务，拥有强大的 Cypher 查询语言。它不仅能处理亿级节点的数据量，还能保持毫秒级的查询响应速度。
2.3 Neo4j 核心特点与功能
核心特点包括：
- 原生图存储，无需 Join 操作即可遍历关系
- 灵活的 Schema 设计，适应业务快速迭代
- 高性能的图遍历算法支持
核心功能涵盖：
- 图可视化与管理工具
- 丰富的驱动支持与生态插件
- 企业级安全与高可用架构
三、环境准备
搭建 Neo4j 服务通常推荐使用 Docker，方便隔离和版本管理。
- 下载镜像
docker pull neo4j:latest - 创建目录
确保宿主机有足够空间存放数据文件，例如
/data/neo4j。 - 启动容器
docker run -d --name neo4j \ -p 7474:7474 -p 7687:7687 \ -v /data/neo4j/data:/data \ -e NEO4J_AUTH=neo4j/password \ neo4j:latest - 访问 Web 界面
浏览器打开
http://localhost:7474，使用默认账号登录即可开始探索。
四、Spring Boot 整合 Neo4j
4.1 前置准备
4.1.1 版本选择
建议选用 Spring Boot 2.x 或 3.x 配合 Spring Data Neo4j 6.x 以上版本，兼容性较好。
4.1.2 导入依赖
在 pom.xml 中添加以下核心依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-neo4j</artifactId>
</dependency>
4.1.3 添加配置文件
在 application.yml 中配置连接地址及认证信息：
spring:
neo4j:
uri: bolt://localhost:7687
authentication:
username: neo4j
password: password
4.2 代码整合过程
4.2.1 自定义节点与实体类映射
我们需要定义一个实体类来映射图中的节点。使用 @NodeEntity 标记类，@Id 标记主键，@Property 标记属性。
import org.neo4j.graphdb.Node;
import org.springframework.data.neo4j.core.schema.*;
@NodeEntity
public class Person {
@Id
private Long id;
@Property("name")
private String name;
// getters and setters
}
注意：实际开发中建议使用 @Node 注解（新版驱动），但为了兼容旧版教程逻辑，此处保留通用写法。
4.2.2 自定义 JPA
继承 GraphRepository 接口，Spring Data 会自动生成基础 CRUD 方法。如果需要复杂查询，可以定义自定义方法名或使用 @Query 注解。
public interface PersonRepository extends GraphRepository<Person> {
List<Person> findByName(String name);
}
4.3 代码整合测试
4.3.1 保存 Person 以及关系数据
创建一个 Service 层来演示如何保存节点并建立关系。
@Service
public class PersonService {
@Autowired
private PersonRepository personRepo;
public void savePerson(Person p) {
personRepo.save(p);
}
}
若需建立'认识'关系，需先获取两个节点实例，然后调用 relationship 相关 API。
4.3.2 查询数据
利用 Repository 的方法进行查询，或者直接使用 Cypher 语句。
List<Person> result = personRepo.findByName("Alice");
4.3.3 JPA 自定义方法规则
Spring Data Neo4j 支持基于方法名的查询推导，也支持 Cypher 注解。对于多表关联查询，Cypher 是更灵活的选择。
五、总结
通过上述步骤，我们完成了从环境搭建到代码集成的全过程。图数据库在处理复杂关系数据时表现优异，结合 Spring Boot 可以快速构建高性能应用。在实际项目中，注意合理设计节点标签和关系类型，避免图结构过于复杂导致维护困难。
