SpringBoot 整合 Neo4j 图数据库项目实战详解

前置准备

版本选择

建议使用 Spring Boot 2.7+ 或 3.x 版本，配合 Spring Data Neo4j 6.x 以上版本，以获得更好的兼容性。

导入依赖

在 pom.xml 中添加以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-neo4j</artifactId>
</dependency>

添加配置文件

在 application.yml 中配置连接信息：

spring:
  neo4j:
    uri: bolt://localhost:7687
    username: neo4j
    password: your_password

注意：生产环境中请务必通过环境变量管理敏感信息。

代码整合过程

自定义节点与实体类映射

定义一个 Person 节点实体。在较新的 SDN 版本中，我们使用 @Node 注解来标识实体类。

import org.springframework.data.neo4j.core.schema.*;

@Node("Person")
public class Person {
    @Id
    private Long id;
    
    @Property("name")
    private String name;
    
    @Property("age")
    private Integer age;

    // 构造函数、Getter/Setter 省略
}

这里的关键是 @Id 标记主键，@Property 指定属性名。如果属性名与字段名一致，可以省略 @Property。

自定义 JPA

继承 Neo4jRepository 即可获取基础 CRUD 能力。如果需要更复杂的查询，可以定义 Cypher 语句。

import org.springframework.data.neo4j.repository.GraphRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface PersonRepository extends GraphRepository<Person> {
    // 方法命名推导
    List<Person> findByName(String name);
    
    // 自定义 Cypher 查询
    @Query("MATCH (p:Person) WHERE p.age > {age} RETURN p")
    List<Person> findAdults(@Param("age") int age);
}

实际开发中，利用方法命名规则能解决大部分简单查询，遇到复杂逻辑再手写 Cypher。

代码整合测试

保存 Person 以及关系数据

编写 Service 层来演示如何保存节点并建立关系。Neo4j 中的关系也是第一类对象。

@Service
public class PersonService {
    @Autowired
    private PersonRepository personRepository;

    public void savePersonAndRelation() {
        Person alice = new Person();
        alice.setName("Alice");
        alice.setAge(25);
        
        Person bob = new Person();
        bob.setName("Bob");
        bob.setAge(30);

        // 保存节点
        Person savedAlice = personRepository.save(alice);
        Person savedBob = personRepository.save(bob);

        // 建立关系：alice KNOWS bob
        Relationship relationship = new Relationship(savedAlice, savedBob, "KNOWS");
        relationship.setProperty("since", LocalDate.now());
        
        // 保存关系
        personRepository.save(savedAlice); // 触发关系保存
    }
}

这里要注意，保存关系通常需要保存包含关系的父节点，具体取决于 SDN 的版本配置。

查询数据

查询部分主要展示两种风格：方法命名和 Cypher。

// 1. 方法命名
List<Person> friends = personRepository.findByName("Alice");

// 2. Cypher 查询多跳关系
@Query("MATCH (a:Person)-[:KNOWS]->(b:Person) WHERE a.name = 'Alice' RETURN b")
List<Person> getFriendsOfAlice();

JPA 自定义方法规则

除了标准 CRUD，还可以利用 Neo4j 的特性扩展。例如查找特定深度的邻居节点。虽然 SDN 不直接支持所有图算法，但可以通过 Cypher 注入实现。例如查找'三度人脉'：

@Query("MATCH path = (a:Person {name: 'Alice'})-[*1..3]-(b:Person) RETURN b")
List<Person> findThreeDegreeConnections();

这比传统数据库的递归 CTE 要简洁得多。

写在文末

通过上述步骤，我们完成了 SpringBoot 与 Neo4j 的基础整合。在实际的微服务架构中，图数据库非常适合处理权限控制、知识图谱、风控反欺诈等强关系场景。需要注意的是，图数据库并非万能，对于简单的 KV 存储或无关系查询，传统数据库依然更高效。选型时应根据业务的数据特征来决定。