创建Neo4j仓库报错：主标签Calendar已存在节点描述

项目代码文件 #

MyGoogleCalendarNeo4jRepository.java #

import org.springframework.data.repository.CrudRepository;

public interface MyGoogleCalendarNeo4jRepository extends CrudRepository<MyGoogleCalendar, String> {}

MyGoogleCalendar.java #

import org.springframework.data.neo4j.core.schema.Id;
import org.springframework.data.neo4j.core.schema.Relationship;

public class GoogleCalendarCalendar {

    @Relationship(type = "ASSOCIATED_TO", direction = Relationship.Direction.OUTGOING)
    private Calendar calendar;
    @Id
    private String id;

    /*
     * Default getters and setters
     */
    ...
 }

Calendar.java #

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

public class Calendar {

    @Id
    private String id;
    private com.google.api.services.calendar.Calendar service;

    /*
     * Default getters and setters
     */
    ...
 }

启动报错信息 #

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name [...] nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'myGoogleCalendarNeo4jRepository' defined in com.[...].MyGoogleCalendarNeo4jRepository defined in @EnableNeo4jRepositories declared on MyApplication: Invocation of init method failed; nested exception is org.springframework.data.mapping.MappingException: The schema already contains a node description under the primary label Calendar

错误原因 #

1. 节点标签冲突：自定义的Calendar实体类未指定显式节点标签，Spring Data Neo4j默认用类名Calendar作为节点主标签；但代码中同时引入了谷歌API的com.google.api.services.calendar.Calendar类，导致Neo4j映射时识别到两个都要使用Calendar作为标签的类型，触发冲突。
2. 实体类与仓库不匹配：仓库接口MyGoogleCalendarNeo4jRepository的泛型是MyGoogleCalendar，但实际对应的实体类却是GoogleCalendarCalendar，属于类名笔误，会进一步加剧映射问题。

解决方法 #

1. 解决标签冲突（二选一） #

方案A：给自定义实体指定显式标签

在自定义Calendar类上添加@Node注解，指定唯一标签名称避开重名：

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

@Node(label = "CustomCalendar") // 自定义唯一标签
public class Calendar {

    @Id
    private String id;
    private com.google.api.services.calendar.Calendar service;

    // getters and setters
}

方案B：重命名自定义实体类

直接修改自定义Calendar类的类名，从根源避免类名冲突，比如改成GoogleCalendarNode：

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

@Node
public class GoogleCalendarNode {

    @Id
    private String id;
    private com.google.api.services.calendar.Calendar service;

    // getters and setters
}

同时修改GoogleCalendarCalendar类中对应的属性类型：

@Relationship(type = "ASSOCIATED_TO", direction = Relationship.Direction.OUTGOING)
private GoogleCalendarNode calendar;

2. 修正实体类与仓库的匹配问题 #

将实体类名和仓库泛型统一，二选一即可：

• 把GoogleCalendarCalendar类改名为MyGoogleCalendar并添加@Node注解：

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

@Node
public class MyGoogleCalendar {

    @Relationship(type = "ASSOCIATED_TO", direction = Relationship.Direction.OUTGOING)
    private Calendar calendar;
    @Id
    private String id;

    // getters and setters
}

• 或者修改仓库接口的泛型为GoogleCalendarCalendar：

public interface MyGoogleCalendarNeo4jRepository extends CrudRepository<GoogleCalendarCalendar, String> {}

内容的提问来源于stack exchange，提问作者j.xavier.atero