Neo4j查询桌面端正常但Python驱动返回空结果求助

以下Python代码调用Neo4j驱动查询关键词"power control"的年度发文量时返回空列表，但将查询语句复制到Neo4j桌面端，把$keyword替换为"power control"后能正常返回结果，数据库认证无问题且无报错，可能的异常原因有哪些？

from neo4j import GraphDatabase


class KeywordPublicationFrequency:

    def __init__(self, uri, user, password):
        self.driver = GraphDatabase.driver(uri, auth=(user, password))

    def close(self):
        self.driver.close()

    def get_publication_frequency(self, keyword):
        with self.driver.session() as session:
            result = session.read_transaction(self._create_and_return_query, keyword)
            print(result)
            for record in result:
                print("Year: ", record['Year'], "Publications: ", record['Publications'])

    @staticmethod
    def _create_and_return_query(tx, keyword):
        query = """
        MATCH (k:KEYWORD {name: $keyword})-[:LABEL_BY]-(p:PUBLICATION)
        RETURN p.year as Year, count(p) as Publications
        ORDER BY Year ASC
        """
        result = tx.run(query, keyword=keyword)
        return list(result)


if __name__ == "__main__":
    kp_frequency = KeywordPublicationFrequency("bolt://localhost:7687", "my username", "my password")
    kp_frequency.get_publication_frequency("power control")
    kp_frequency.close()

可能的异常原因 #

• 属性匹配精度问题：数据库中KEYWORD节点的name属性可能存在大小写、空格差异，比如实际存储为"Power Control"或"power control"（双空格），而Python传入的参数是"power control"（单空格），导致精确匹配失败。
• 数据库上下文不一致：Neo4j桌面端查询的是默认数据库，但Python驱动连接的是其他数据库。可以在创建session时指定数据库，比如session = self.driver.session(database="your-target-db")，确认两端操作的是同一个库。
• 关系类型/标签大小写问题：Neo4j的标签和关系类型是区分大小写的，比如Python代码中写的:LABEL_BY，如果数据库中实际的关系类型是:label_by（小写），就会匹配失败；同理KEYWORD、PUBLICATION标签也需要检查大小写是否和数据库一致。
• 字符编码差异：关键词中的空格或特殊字符存在全角/半角、编码不一致的情况，比如Python传入的是半角空格，数据库中存储的是全角空格，导致匹配失效。
• 参数类型不匹配：如果数据库中KEYWORD.name的类型不是字符串（比如误存为数值或其他类型），Python传入的字符串参数会无法匹配，而桌面端直接写字符串可能被隐式转换（概率较低，但需排查）。
• 索引失效或未命中：如果KEYWORD.name没有创建索引，或索引因数据变更失效，可能导致Python驱动的查询无法正确定位节点；不过桌面端查询正常的话这个概率不高，但可以通过CALL db.indexes()检查索引状态。

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