关于使用Py2neo连接Neo4j图数据库出现“ValueError: The following settings are not supported”报错的解决方案

关于使用Py2neo连接Neo4j图数据库出现“ValueError: The following settings are not supported: {'username': 'neo4j'} ”报错的解决方案。

---

1.问题成因及解决

pip install py2neo  //目前使用pip安装的py2neo版本为2021.1

• 出现该报错的根本原因是：通过pip安装的Py2neo默认为最新版本（Py2neo 2021.1），该版本（或更早版本）相比此前流行的主流版本（如4.3.0），变更了用于连接Neo4j数据库的Connection profiles指令格式，因此旧版Py2neo教程中给出的连接指令无法起作用。
• 在Py2neo 2021.1版本中坚持使用旧版Connection profiles指令则会提示：ValueError: The following settings are not supported: {'username': 'neo4j'} 

解决方案：

• 选项①：使用如下文所示的新版Connection profiles指令；
• 选项②：安装低版本的Py2neo，详见：带鱼工作室

2.新旧版本Py2neo的Connection profiles指令对比

//旧版Connection profiles示例
from py2neo import *
graph = Graph('http://localhost:7474/',username='neo4j',password='123456')

//py2neo 2021.1版本的Connection profiles示例
from py2neo import *
graph = Graph("http://localhost:7474", auth=("neo4j", "123456"))

//详见py2neo 2021.1版本官方手册：https://py2neo.org/2021.1/profiles.html

3.吐槽

• 正如各位前辈所吐槽的，Neo4j生态的向下兼容做的属实不大行，很多经验贴有时候只能是拿来参考，邯郸学步迟早踩坑...
• 如果出于一些原因不得不使用新版Py2neo，建议自行研读The Py2neo Handbook 2021.1保平安。