Python操作Neo4j报参数未访问、ParameterMissing错误排查

两个报错是同一个代码问题引发的连带结果，另外还有一处建模逻辑漏洞：

• 核心缺陷：tx.run() 调用时仅传入了Cypher查询字符串，没有给语句里的$disease、$drug占位符绑定对应入参，Neo4j拿不到参数值就会抛出Expected parameter(s): disease, drug错误。同时函数定义的disease、drug两个形参完全没在函数体内被使用，Pylance静态检查检测到未引用参数才弹出"参数未被访问"的提示，这个提示不是误报。
• 建模逻辑错误：当前Cypher把疾病实体也打上了Medicine标签，和药品实体类型混淆，后续做关系查询、实体统计时会出现数据错误。

补全tx.run()的参数绑定逻辑，同时修正实体标签，完整代码如下：

from neo4j import GraphDatabase

# 驱动连接信息按自身实际环境修改
driver = GraphDatabase.driver("bolt://localhost:7687", auth=("neo4j", "your_db_password"))

def add_medicine(tx, disease, drug):
    tx.run(
        "CREATE (d:Disease {name: $disease}) "
        "CREATE (m:Medicine {name: $drug}) "
        "CREATE (d)-[:TREAT]->(m) "
        "RETURN d, m",
        disease=disease,
        drug=drug
    )

with driver.session() as session:
    # 4.x版本驱动用write_transaction，5.x+版本可替换为execute_write，接口兼容
    session.write_transaction(add_medicine, "Fever", "Water")

driver.close()

注意事项 #

• 参数绑定支持两种写法：上面用的是关键字参数传参，也可以传入字典形式{"disease": disease, "drug": drug}作为tx.run的第二个参数，效果完全一致
• 修复后两个形参被正常传入查询逻辑，Pylance的未访问提示会自动消除
• 代码里统一用name作为实体名称的属性名，是图库建模的通用规范，避免不同类型实体的名称属性名不统一增加后续查询成本；如果要保留原有属性命名，只需要补全参数传参即可，但标签错误建议必须修正。

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