在Django中使用neomodel操作Neo4j，数据库浏览器无节点显示

问题重现 #

在Django应用中使用neomodel操作Neo4j，配置如下：

NEOMODEL_NEO4J_BOLT_URL = os.environ.get('NEO4J_BOLT_URL')
NEOMODEL_SIGNALS = True
NEOMODEL_FORCE_TIMEZONE = False
NEOMODEL_ENCRYPTED_CONNECTION = True
NEOMODEL_MAX_POOL_SIZE = 50

定义Person模型：

class Person(StructuredNode):
    SEXES = {
        'm': 'Male',
        'f': 'Female',
    }

    id = properties.UniqueIdProperty()
    first_name = properties.StringProperty(unique_index=True, required=True, max_length=100)

    gender = properties.StringProperty(choices=SEXES, required=True)

在Django Shell执行创建操作后，返回了对象实例，但Neo4j数据库浏览器中无节点，调用person.refresh()抛出PersonDoesNotExist异常：

>>> from family_tree.models import Person
>>> person = Person(first_name='Anuj', gender='m')
>>> person.save()
<Person: {'id': '572d0b8ff3a8402ba58c4a03cace78ba', 'first_name': 'Anuj', ...}>
>>> person.refresh()
neomodel.core.PersonDoesNotExist: (PersonDoesNotExist(...), "Can't refresh non existent node")

排查与解决步骤 #

1. 验证连接配置正确性 #

• 检查NEO4J_BOLT_URL环境变量是否有效，格式应为bolt://<用户名>:<密码>@<主机>:<端口>或neo4j+s://...（对应加密连接），可在Shell中直接打印确认：

  import os
  print(os.environ.get('NEO4J_BOLT_URL'))
  

• 若本地测试Neo4j未开启加密，将NEOMODEL_ENCRYPTED_CONNECTION改为False，或确保服务器加密配置与客户端匹配。

2. 显式控制事务提交 #

neomodel自动事务可能因隐性问题未提交，尝试手动事务或强制保存：

from neomodel import db
# 方式1：显式事务
with db.transaction:
    person = Person(first_name='Anuj', gender='m')
    person.save()
# 方式2：强制保存
person = Person(first_name='Anuj', gender='m')
person.save(force=True)

3. 检查索引与约束冲突 #

• 模型中first_name设为唯一索引，若数据库中已存在同名节点，会导致保存失败但无显性报错，尝试用新的first_name创建节点测试。
• 手动同步模型的索引和约束到数据库：

  neomodel_install_labels family_tree/models.py --db <你的Bolt URL>
  

4. 确认数据库用户权限 #

• 登录Neo4j浏览器，使用配置的用户执行原生Cypher语句测试写入权限：

  CREATE (p:Person {first_name:'Test', gender:'m'}) RETURN p
  

  若执行失败，检查用户是否拥有CREATE、MERGE等写入权限。

5. 检查版本兼容性 #

确认neomodel与Neo4j版本匹配，例如neomodel 5.x需对应Neo4j 4.4及以上版本，版本不兼容可能导致隐性写入失败。

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