如何使用Neo4j存储/加载不可变对象？（Spring Boot环境）

你遇到的这个MappingException本质是Neo4j OGM（对象图映射器）在处理不可变final字段时的默认行为导致的——SDN 4.x的OGM默认会优先尝试用无参构造创建实例，再反射填充字段，但final字段无法通过反射修改，同时@GraphId标记的final字段如果没被正确注入，就会触发"找不到标识字段"的异常。

下面是针对你的场景的具体解决方案：

1. 重构实体类：移除无参构造，保留全参构造 #

不可变对象的核心是通过构造函数一次性初始化所有字段，OGM 2.x（对应SDN 4.2.x）支持通过全参构造函数注入字段值，不需要依赖Setter或反射修改。修改后的Element类如下：

public class Element { 
    @GraphId 
    private final Long id; 
    private final String name; 
    private final Integer atomicWeight; // 注意：原代码的Int是Java的Integer，笔误修正

    // 必须包含所有字段的全参构造，包括@GraphId标记的id
    public Element(Long id, String name, Integer atomicWeight) {
        this.id = id;
        this.name = name;
        this.atomicWeight = atomicWeight;
    }

    // 仅保留Getter方法，不可变对象不需要Setter
    public Long getId() { return id; }
    public String getName() { return name; }
    public Integer getAtomicWeight() { return atomicWeight; }
}

2. 关键原理说明 #

• OGM在加载实体时，会直接调用全参构造函数，将数据库中读取的节点ID、name、atomicWeight值作为参数传入，这样所有final字段都能被正确初始化，避免了反射修改final字段的问题。
• @GraphId标记的id字段必须包含在构造函数中，这样OGM才能识别到这是实体的标识字段，解决"No identity field found"的异常。

3. 特殊场景处理（如果必须保留无参构造） #

如果因为某些框架约束必须保留无参构造，可以结合@ConstructorProperties注解明确指定构造函数参数与字段的映射关系，示例如下：

public class Element { 
    @GraphId 
    private final Long id; 
    private final String name; 
    private final Integer atomicWeight; 

    // 无参构造（仅在必要时保留）
    private Element() {
        this.id = null;
        this.name = null;
        this.atomicWeight = null;
    }

    // 全参构造+@ConstructorProperties指定参数映射
    @ConstructorProperties({"id", "name", "atomicWeight"})
    public Element(Long id, String name, Integer atomicWeight) {
        this.id = id;
        this.name = name;
        this.atomicWeight = atomicWeight;
    }

    // Getter方法
    // ...
}

不过这种方式不如直接移除无参构造简洁，更推荐纯不可变的实现方式。

内容的提问来源于stack exchange，提问作者MatanRubin