Neo4j执行Cypher创建节点报ConfigNode无效输入错误如何解决

一共三个诱发问题，直接对应异常和代码逻辑缺陷：

• 核心语法错误：Cypher语法规定节点标签属于标识符，不能用单引号包裹。原语句写的CREATE(m:'ConfigNode')给标签加了单引号，解析器在该位置期望拿到合法标识符，实际碰到字符串字面量的起始单引号，直接抛出你看到的ClientException，异常提示的偏移量位置刚好对应该单引号的位置。
• Cypher逻辑错误：UNWIND document.data AS data执行后，data已经是单条节点的属性Map（即传入数组里的每个对象），不是可遍历的集合，后续套FOREACH (node in data| ...)属于逻辑错误，会尝试遍历Map的键值对，完全不符合批量创建的预期。
• 参数传递错误：代码里手动用Gson拼接了JSON格式的入参字符串，但全程没有把参数放入传给session.run()的parameters Map中，Cypher语句里引用的$batch参数实际没有传入值，就算修复语法错误也会触发参数缺失异常。另外Neo4j Java驱动本身支持直接传入Java集合、Map类型作为参数，不需要手动转JSON字符串。

首先修正Cypher语句：去掉标签两侧的单引号、删除多余的FOREACH遍历，调整变量名避免歧义：

// 修正后的Cypher语句
String cypher = "WITH $batch AS document " +
                "UNWIND document.data AS nodeProps " +
                "CREATE(m:ConfigNode) SET m = nodeProps";

然后修正参数传递逻辑，直接构造参数Map传入，不需要手动序列化JSON：

Map<String, Object> parameters = new HashMap<>();
// 直接构造参数结构，驱动自动完成类型序列化
Map<String, Object> batchParam = new HashMap<>();
batchParam.put("data", nodes); // nodes为业务侧生成的节点属性List
parameters.put("batch", batchParam);

try (Session session = getWriteTenantDBSession(driver, tenantId)) {
    session.run(cypher, parameters);
} catch(Exception e) {
    e.printStackTrace();
    throw new UnableToSupportOpException("Unable to create node due to exception:" + e.getLocalizedMessage());
}

如果需要避免相同uuid的节点重复创建，可以把CREATE替换为MERGE，同时提前给uuid属性创建唯一约束提升写入性能：

// 约束仅需在库中执行一次，不要放在业务代码里重复调用
CREATE CONSTRAINT IF NOT EXISTS FOR (n:ConfigNode) REQUIRE n.uuid IS UNIQUE;

对应的业务Cypher调整为：

String cypher = "WITH $batch AS document " +
                "UNWIND document.data AS nodeProps " +
                "MERGE(m:ConfigNode {uuid: nodeProps.uuid}) SET m = nodeProps";

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