Cypher脚本collection/Pair错误及cypher-shell提示符异常排查

错误原因 #

1. org/neo4j/internal/helpers/collection/Pair错误：
   该错误是Neo4j 4.4.x版本中脚本化事务（:begin/:commit块）的参数解析逻辑bug导致的。在事务块内部直接定义或使用参数时，cypher-shell的参数处理逻辑会触发内部集合类的调用异常，属于该版本已知的兼容性问题。
2. 提示符从>变为#：
   #是cypher-shell的未闭合事务状态提示符，说明当前事务块因错误中断未正常结束，shell进入等待事务闭合的状态，需手动执行:rollback或:commit才能回到正常交互状态。

解决方案 #

1. 参数提前声明（推荐） #

将所有参数定义移到事务块外部，使用:param命令提前声明后，再在事务块内引用：

// 事务块外预定义所有参数
:param measured => ["temperature", "humidity"];
:param vals => [{"metric": "temp", "value": 25}, {"metric": "humid", "value": 60}];

// 第一个事务块
:begin
MATCH (d:Device {id: "sensor_001"})
UNWIND $measured AS m
MERGE (d)-[:MONITORS]->(s:Sensor {type: m})
:commit

// 第二个事务块
:begin
UNWIND $vals AS v
MATCH (s:Sensor {type: v.metric})
SET s.reading = v.value
:commit

2. 命令行传入参数 #

如果参数需要动态生成，可通过cypher-shell的--parameter（简写-p）命令行参数传入，避免在脚本内的事务块中定义参数：

cypher-shell -u neo4j -p your_password --parameter measured='["temperature", "humidity"]' --parameter vals='[{"metric":"temp","value":25}]' -f your_script.cypher

3. 升级Neo4j版本 #

官方在Neo4j 4.4.20及后续补丁版本中修复了部分脚本化事务的参数解析bug，升级到对应版本可直接解决该问题。

额外注意事项 #

• Neo4j 4.x的脚本化事务语法属于实验性特性，参数支持不如非事务场景稳定，尽量遵循"参数提前声明"的原则。
• 若错误依然存在，可使用cypher-shell --debug执行脚本，查看完整堆栈信息定位具体语句问题。

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