Python调用Neo4j创建User节点时报ParameterMissing参数缺失错误

你在Cypher语句中使用了$username_形式的参数占位符，但调用session.run()执行查询时，没有显式将该占位符对应的参数值传递给Neo4j驱动，驱动找不到声明的参数，因此抛出Statement.ParameterMissing类型的客户端错误。
Neo4j Python驱动不会做“Python变量名和Cypher占位符同名就自动匹配传值”的隐式操作，所有Cypher里声明的$开头的参数，都必须在执行查询时显式传入。

在session.run()的参数列表中，把Cypher需要的参数以键值对形式补上即可，修改后的函数代码：

def add_user(username_):
    q1 = "CREATE (u:User) SET u.name= $username_"
    # 显式传入Cypher占位符对应的参数值
    nodes = session.run(q1, username_=username_)

• 如果需要避免重复创建同用户名的节点，可以把CREATE替换为MERGE，简化后的语句如下：

  q1 = "MERGE (u:User {name: $username_})"
  nodes = session.run(q1, username_=username_)
  

• 按照Neo4j Python驱动的最佳实践，不要在全局范围持有长生命周期的session实例，建议每次执行数据库操作时临时创建session，操作完成后自动关闭，避免连接资源泄漏。
• 参数传递支持字典格式传入，和之前的关键字传参写法完全等价：

  nodes = session.run(q1, {"username_": username_})
  

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