Spring Data Neo4j 7.1.1关联仅返回空集合问题求助

问题背景 #

使用Spring 3.1.1搭配Spring Data Neo4j（SDN）7.1.1开发，定义了Book等节点类并配置了双向无属性关联。当前遇到两个核心问题：

• 查询Book节点后，调用关联属性的Getter返回空集合，但数据库中确实存在对应关联关系；
• 内置查询方法findOneByTitle执行时陷入循环，手动编写的@Query能快速返回正确节点，但关联集合仍为空。
  已尝试添加Lombok的@ToString.Include注解，测试响应式与普通SDN仓库，问题均未解决。

相关代码 #

其他类关联配置示例

@Relationship(type = "writtenBy", direction = INCOMING)
private Set<Book> writtenBy = Collections.emptySet();

BookRepository代码

@Repository
public interface BookRepository extends Neo4jRepository<Book, String> {
   Optional<Book> findOneByTitle(String title);
    boolean existsByTitle(String title);
    @Query("MATCH (book:Book) WHERE book.title = $title RETURN book")
    Book findABookManual(@Param("title") String title);
}

Book实体类代码

import lombok.*;
import org.springframework.data.neo4j.core.schema.Id;
import org.springframework.data.neo4j.core.schema.Node;
import org.springframework.data.neo4j.core.schema.Property;
import org.springframework.data.neo4j.core.schema.Relationship;

import java.util.*;

import static org.springframework.data.neo4j.core.schema.Relationship.Direction.INCOMING;
import static org.springframework.data.neo4j.core.schema.Relationship.Direction.OUTGOING;


@Data
@NoArgsConstructor
@ToString
@Node("Book")

public class Book {

    @Id
    private String title;
    @Property("characters")
    private List<String>characters;
    @Property("genres")
    private List<String> genres;
    @Property("description")
    private String description;
    @Property("bookFormat")
    private String bookFormat;
    @Property("loan")
    private boolean loan;

    @ToString.Include
    @Relationship(type = "published", direction = INCOMING)
    private Set<Publisher> publishers = Collections.emptySet();

    @ToString.Include
    @Relationship(type = "hasFormat", direction = OUTGOING)
    private Set<BookFormat> bookFormats = Collections.emptySet();

    @ToString.Include
    @Relationship(type = "writtenBy", direction = OUTGOING)
    private Set<Author> authors = Collections.emptySet();

    @ToString.Include
    @Relationship(type = "publishedIn", direction = OUTGOING)
    private Set<PublishDate> publishDates = Collections.emptySet();

    @ToString.Include
    @Relationship(type = "hasBorrowed", direction = INCOMING)
    private Set<LibraryUser> Borrowers = Collections.emptySet();

    public Book (String title, List<String> characters, List<String> genres, String description, String bookFormat, boolean loan) {
        this.title = title;
        this.characters = characters;
        this.genres = genres;
        this.description = description;
        this.bookFormat = bookFormat;
        this.loan = loan;
    }
}

问题原因分析 #

1. 关联集合为空：SDN默认对关联关系采用懒加载策略，手动编写的@Query仅返回Book节点本身，未匹配关联关系语句，导致关联集合无法被填充；内置查询因双向关联触发无限递归，进而导致关联加载异常。
2. 内置查询循环：Lombok的@Data/@ToString会自动生成包含关联对象的toString方法，双向关联实体互相调用toString时引发无限循环。

解决方案 #

1. 解决关联集合为空的问题 #

方法一：修改手动@Query，显式匹配关联关系

手动查询需明确匹配关联节点，SDN才能自动映射到实体关联属性。以加载authors和publishers为例：

@Query("MATCH (book:Book) WHERE book.title = $title " +
       "OPTIONAL MATCH (book)-[:writtenBy]->(author:Author) " +
       "OPTIONAL MATCH (publisher:Publisher)-[:published]->(book) " +
       "RETURN book, collect(author) as authors, collect(publisher) as publishers")
Book findABookManual(@Param("title") String title);

方法二：开启关联急加载

在@Relationship注解上添加fetch = Fetch.EAGER，强制加载Book时同时加载关联：

@ToString.Include
@Relationship(type = "published", direction = INCOMING, fetch = Fetch.EAGER)
private Set<Publisher> publishers = new HashSet<>();

@ToString.Include
@Relationship(type = "writtenBy", direction = OUTGOING, fetch = Fetch.EAGER)
private Set<Author> authors = new HashSet<>();

注意：急加载会增加查询开销，仅在确需立即获取关联时使用。

方法三：初始化可变关联集合

将Collections.emptySet()改为可变集合，SDN加载关联时才能添加元素：

private Set<Publisher> publishers = new HashSet<>();
private Set<Author> authors = new HashSet<>();
// 其他关联集合同理

2. 解决内置查询循环的问题 #

方法一：修改Lombok注解，排除关联属性的toString

用@ToString(exclude)排除关联属性，避免递归调用：

@Data
@NoArgsConstructor
@ToString(exclude = {"publishers", "bookFormats", "authors", "publishDates", "Borrowers"})
@Node("Book")
public class Book {
    // ... 实体内容
}

方法二：添加序列化忽略注解（若涉及前端序列化）

在双向关联的其中一方添加@JsonIgnore，避免Jackson递归序列化：

@JsonIgnore
@Relationship(type = "writtenBy", direction = OUTGOING)
private Set<Author> authors = new HashSet<>();

额外检查项 #

• 确认双向关联的方向与数据库中关系方向一致；
• 确保@Relationship的type参数与数据库关系类型完全匹配（大小写敏感）。

内容的提问来源于stack exchange，提问作者Fabian Z.