Neo4j作为一款流行的图数据库，默认使用账号neo4j进行登录，初始密码也是neo4j。首次通过浏览器访问http://127.0.0.1:7474时，系统会强制要求修改初始密码。不过实际使用中，经常有开发者因为长时间没有操作数据库，或者交接项目时没有记录好密码，导致再次连接时提示密码错误。这篇文章就围绕Neo4j密码重置这个话题，把社区里验证过有效的几种方法完整梳理一遍，并说明每种方法适用的版本和注意事项。
方法一：使用neo4j-admin命令重置初始密码
这是官方推荐的标准做法，适合数据库中还没有重要数据、可以接受重新初始化认证信息的场景。操作之前需要先停止Neo4j服务，因为认证文件在被进程占用时无法写入。在Windows环境下，可以先在命令行执行neo4j stop，或者在服务管理器中停止Neo4j服务；Linux环境下则使用systemctl stop neo4j或者./bin/neo4j stop。
服务停止后，进入Neo4j的安装目录，在bin目录下执行重置命令。以4.x版本为例，命令格式如下：
cd /usr/share/neo4j/bin ./neo4j-admin set-initial-password 新密码
执行成功后，控制台不会有明显的报错信息，此时认证文件会被重置为初始状态，使用账号neo4j加上刚才设置的新密码即可登录。需要注意的是，在3.x版本中这个命令位于neo4j-admin中，而更早的版本则叫neo4j-shell，命令参数也略有不同。如果你不确定自己的版本，可以先执行neo4j-admin --version查看。
这个方法有一个重要限制：set-initial-password顾名思义是设置初始密码，它只有在数据库尚未建立用户认证数据时才生效。也就是说，如果你之前已经成功修改过密码并且数据库里有存量用户数据，直接执行这个命令可能不会改变现有密码。这种情况下就要用到下面第二种方法。
方法二：删除auth.ini认证文件强制重置
当方法一不奏效时，最直接有效的手段是删除认证文件。Neo4j把账号密码信息保存在一个叫auth.ini的文件中，不同版本路径略有差异：3.x版本位于data\dbms\auth.ini，4.x和5.x版本位于data\dbms\auth.ini或data\dbms\roles.ini配套存在。Windows安装版默认在安装目录下的data文件夹中，比如D:\neo4j\data\dbms\auth.ini；Linux的tar包安装则在解压目录下对应路径。
操作步骤同样要求先停止Neo4j服务，然后找到并删除auth.ini文件（建议先复制一份备份，以防操作失误），再重新启动服务：
systemctl stop neo4j cd /var/lib/neo4j/data/dbms cp auth.ini auth.ini.bak rm -f auth.ini systemctl start neo4j
服务重启后，Neo4j会认为这是一个全新的数据库实例，账号回到neo4j、密码回到neo4j的初始状态。此时打开浏览器访问7474端口，系统会再次弹出修改初始密码的界面，按提示设置新密码即可完成整个重置流程。
这里要特别提醒一点：删除auth.ini只会影响认证数据，不会删除图的节点和关系数据，所以不必担心图数据丢失。但如果你的数据库中还配置了其他自定义用户和角色，这些信息也会一并被清除，重置后需要重新创建。另外，Docker部署的用户稍微特殊一些，认证文件挂载在容器卷里，需要先确认卷的映射路径，再进入容器或直接在宿主机挂载目录中删除对应文件。
方法三：修改配置文件临时关闭密码认证
如果不想删除任何文件，还有一种思路是绕过认证。打开conf目录下的neo4j.conf配置文件，找到下面这一行：
dbms.security.auth_enabled=false
在部分版本中这一行默认是被注释掉的，前面的井号需要去掉。将其值改为false后保存，重启Neo4j服务。此时连接数据库不再校验密码，任何密码都可以登录进去。登录成功后，可以通过Cypher语句直接修改密码：
ALTER CURRENT USER SET PASSWORD FROM '旧密码' TO '新密码';
在3.x版本中修改密码的语句是CALL dbms.changePassword('新密码');，写法不同但效果一致。修改完成后，强烈建议立刻把dbms.security.auth_enabled改回true并重启服务，恢复密码认证。长期关闭认证会让数据库暴露在裸奔状态，尤其生产环境绝对不能这样做。
这种方法的好处是不动任何数据文件，风险最小，特别适合数据重要、不敢随便删文件的生产库。缺点是需要改动配置并重启两次服务，操作步骤稍多一些。另外要注意，如果配置文件中写的是dbms.security.auth_enabled=true但仍然登录失败，可以检查一下是否有多处配置互相覆盖，比如环境变量NEO4J_dbms_security_auth__enabled也会影响最终生效的值。
重置后仍无法登录的排查思路
按照上面的方法操作后，理论上都能顺利恢复访问。但实际中也遇到过重置后依然提示密码错误的情况，这里列出几个常见的排查方向。
第一，确认连接的确实是目标实例。本机可能同时装了多个Neo4j，或者Docker里跑了几个容器，改的是A实例的密码，连的却是B实例，自然登录不上。可以通过neo4j status或者docker ps确认服务端口归属。第二，检查 bolt 端口和 http 端口的区别，浏览器用7474，驱动程序用7687，确认地址没有写错。第三，密码中如果包含特殊字符，在命令行执行set-initial-password时可能被shell解析，建议用引号包裹起来。第四，社区版和企业版在用户管理上有差异，企业版支持多用户和角色，重置操作影响的范围更大，操作前最好做好备份。
总结一下，最稳妥的流程是：先停服务，尝试neo4j-admin set-initial-password；不行就删除data\dbms\auth.ini；对数据敏感的场景则用关闭认证加Cypher改密的方式。三种方法覆盖了绝大多数版本和部署形态，按需选用即可。日常使用中，建议把密码记录到安全的密码管理工具里，避免下次再走一遍重置流程。