如何在Neo4j扩展存储过程中返回嵌套对象（无需JSON序列化）

当然可以不用将对象序列化为JSON来返回嵌套结构，但你的当前实现忽略了Neo4j存储过程的序列化规则，这才导致了驱动解码异常和浏览器无响应的问题。

问题根源 #

Neo4j通过PackStream协议在数据库和驱动之间传输数据，它只能自动序列化特定类型：基本类型（字符串、数字、布尔值）、Neo4j内置的实体（节点、关系、路径），以及Map、List这类标准集合类型。你自定义的A和Output类不属于这些支持的类型，Neo4j无法正确将它们打包成PackStream格式，驱动端解码时自然会抛出IndexOutOfBoundsException这类异常。

修正方案：使用Neo4j支持的嵌套结构 #

你可以用Map<String, Object>来模拟嵌套对象，这样Neo4j能自动处理序列化，无需额外JSON转换。这里是修正后的代码示例：

import org.neo4j.procedure.*;
import java.util.Map;
import java.util.stream.Stream;

public class MyProcedure {

    // 用Map模拟嵌套对象A
    private Map<String, String> createA(String aValue) {
        return Map.of("a", aValue);
    }

    // 输出结构保留原有包装类
    public static class Output {
        public Object out;
        public Output(Object out) {
            this.out = out;
        }
    }

    @Procedure(value = "my_proc", mode = Mode.READ)
    public Stream<Output> myProc() {
        // 用Map替代自定义A类
        return Stream.of(new Output(createA("a")));
    }
}

或者更简洁的方式，直接返回嵌套Map，省去额外的Output包装类：

import org.neo4j.procedure.*;
import java.util.Map;
import java.util.stream.Stream;

public class MyProcedure {

    @Procedure(value = "my_proc", mode = Mode.READ)
    public Stream<Map<String, Object>> myProc() {
        Map<String, String> nestedObj = Map.of("a", "a");
        return Stream.of(Map.of("out", nestedObj));
    }
}

验证效果 #

执行call my_proc();后，Neo4j浏览器会正确显示嵌套结构：

+----------------+
| out            |
+----------------+
| {a: "a"}       |
+----------------+

Java驱动也能正常解码结果，不会抛出异常。

进阶：自定义类型序列化（可选） #

如果一定要使用自定义类，你可以实现Neo4j的TypeSystem和Writeable接口来注册自定义序列化逻辑，但这会增加复杂度。对于大多数场景，用Map模拟嵌套对象已经足够简单高效。

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