SpringBoot 整合 Neo4j 图数据库实战指南

4.1 前置准备

4.1.1 版本选择

建议使用 Spring Boot 2.x 或 3.x 版本，配合对应的 Spring Data Neo4j 版本。两者兼容性良好，无需过度纠结具体小版本号，保持主版本一致即可。

4.1.2 导入依赖

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

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

4.1.3 添加配置文件

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

spring.neo4j.uri=bolt://localhost:7687
spring.neo4j.authentication.username=neo4j
spring.neo4j.authentication.password=your_password

注意：实际生产中请将密码放入环境变量或配置中心，避免硬编码。

4.2 代码整合过程

4.2.1 自定义节点与实体类映射

定义一个 Person 节点，使用 @NodeEntity (旧版) 或 @Node (新版) 注解。这里以较通用的方式为例：

import org.neo4j.graphdb.Node;
import org.springframework.data.neo4j.core.schema.Node;
import org.springframework.data.neo4j.core.schema.GeneratedValue;
import org.springframework.data.neo4j.core.schema.Id;

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

    // Getter and Setter omitted for brevity
}

这样，Neo4j 会自动将 Person 类映射为带有标签 Person 的节点。

4.2.2 自定义 Repository

继承 Neo4jRepository 接口，即可获得基础的 CRUD 能力：

import org.springframework.data.neo4j.repository.Neo4jRepository;
import java.util.List;

public interface PersonRepository extends Neo4jRepository<Person, Long> {
    List<Person> findByName(String name);
}

如果需要更复杂的查询，可以结合 Cypher 语句自定义方法。

4.3 代码整合测试

4.3.1 保存 Person 以及关系数据

创建一个 Service 层来演示如何保存节点并建立关系：

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

    public void savePersonAndRelation() {
        Person tom = new Person();
        tom.setName("Tom");
        tom.setAge(25);
        
        Person jerry = new Person();
        jerry.setName("Jerry");
        jerry.setAge(20);

        // 保存节点
        personRepository.save(tom);
        personRepository.save(jerry);

        // 建立 KNOWS 关系
        // 注意：实际项目中需获取两个实体的引用对象
        // Relationship relationship = tom.createRelationshipTo(jerry, Type.KNOWS);
        // personRepository.save(tom); // 保存关系
    }
}

这里要注意，关系也是图的一部分，保存节点后需要显式构建关系并再次保存。

4.3.2 查询数据

利用 JPA 风格的方法进行查询：

public void queryData() {
    // 查找所有年龄大于 20 的人
    List<Person> adults = personRepository.findAllByAgeGreaterThan(20);
    
    // 或者使用 Cypher 查询
    // List<Person> result = personRepository.findByCustomQuery(...);
}

4.3.3 JPA 自定义方法规则

Spring Data Neo4j 支持从方法名派生查询，类似于 Spring Data JPA。例如 findByNameStartingWith 会生成 WHERE n.name STARTS WITH ? 的 Cypher 语句。对于复杂的多跳查询，建议直接使用 @Query 注解编写原生 Cypher。

五、写在文末

通过上述步骤，我们完成了 SpringBoot 与 Neo4j 的基础整合。图数据库在处理复杂关系数据时表现优异，但也需要注意其学习曲线和运维成本。在实际项目中，建议先评估业务场景是否真的需要图结构，避免过度设计。希望这篇指南能帮助你快速上手图数据库开发。