neo4j-graphql-js带Cypher指令的Mutation执行成功却返回null问题

核心错误原因 #

• Cypher缩进逻辑错误：你当前代码中的WITH s被归到了ON CREATE分支内部，只有首次创建新Car节点时才会执行后续关联Owner、返回节点的逻辑。如果Car已存在，会直接跳过ON CREATE后的所有逻辑，最终无返回值。
• 语法隐患：ON CREATE SET语句的最后一个字段赋值后多了多余逗号，部分执行环境会触发解析异常。
• 边界场景未兼容：如果MATCH(o:Owner {id: $cypherParams.currentUserId})没有匹配到对应Owner节点，后续逻辑会直接中断，无返回值，与你定义的非空返回类型Car!冲突，触发Cannot return null for non-nullable field报错。

修复后代码 #

CreateCar(data: CarInput!): Car!
    @cypher(
        statement: """
        MERGE(s:Car {name: $data.name})
           ON CREATE
            SET s.id = apoc.create.uuid(), s.name = $data.name, s.description = $data.description, s.category = $data.category
        WITH s
        OPTIONAL MATCH(o:Owner {id: $cypherParams.currentUserId})
        WHERE o IS NOT NULL
        MERGE(o)-[:OWNS]->(s)
        RETURN s
        """
    )

修复说明 #

• 将WITH s挪到ON CREATE块外部，不管Car是新创建还是已存在，都会执行后续逻辑，保证始终有返回值。
• 删除了SET语句末尾多余的逗号，消除语法隐患。
• 把MATCH改为OPTIONAL MATCH并增加Owner非空判断，即使没有匹配到对应Owner，也会正常返回Car节点，不会中断查询。

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