You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

Neo4j Desktop数据库启动失败,修改端口后仍报错求助

解决Neo4j Desktop数据库冲突与WebSocket连接失败问题

我之前也碰到过一模一样的Neo4j启动冲突+WebSocket连接失败的问题,给你几个亲测有效的排查和解决步骤:

  • 先确认新端口是否被占用
    修改端口(bolt:11005、http:11006)后,先别急着启动数据库,得先检查这些端口有没有被其他进程占了:

    • Windows用户:打开命令提示符,输入 netstat -ano | findstr "11005"netstat -ano | findstr "11006",找到对应的PID后,去任务管理器结束那个进程。
    • macOS/Linux用户:用 lsof -i :11005ss -tulpn | grep 11005 定位占用进程,然后用kill命令杀掉它。
  • 彻底清除Neo4j残留进程
    有时候修改配置后,旧的Neo4j进程会留在后台偷偷占用资源。先完全关闭Neo4j Desktop(别只关窗口,要在任务管理器/活动监视器里确认进程都退出了),然后重启电脑,再尝试启动数据库。

  • 检查数据库目录的权限与锁定状态
    如果你的Neo4j数据库存储目录被杀毒软件、云同步工具(比如OneDrive、Dropbox)锁定,或者当前用户没有读写权限,也会导致启动失败。找到数据库的存储路径,手动确认权限(Windows右键看属性,Linux用chmod命令),同时暂时关闭可能扫描该目录的安全软件。

  • 核对WebSocket连接的配置细节
    针对ServiceUnavailable: WebSocket连接失败的错误,你要注意这几点:

    • 浏览器里访问的URL必须和新端口匹配:把原来的http://localhost:7474改成http://localhost:11006
    • 如果开启了加密连接(bolt+s或https),得确保浏览器信任Neo4j的证书。可以手动把证书导入浏览器的信任列表,或者暂时关闭加密测试(修改neo4j.conf里的dbms.connector.bolt.tls_level=DISABLED)。
  • 查看Neo4j日志找根本原因
    日志才是排查问题的核心!在Neo4j Desktop里找到对应数据库的「Logs」选项,打开neo4j.logdebug.log,里面会有更详细的错误提示——比如端口绑定失败、配置文件语法错误,或者数据库文件损坏。

小提醒:如果修改neo4j.conf后还是不行,建议先备份当前配置文件,然后恢复默认配置,再重新修改端口,避免配置里有其他冲突的设置。

内容的提问来源于stack exchange,提问作者Mirko Giugliano

火山引擎 最新活动