Ruby连接Neo4j报错uninitialized constant Neo4j::Session(NameError)求解决

这个错误的核心原因是你用了过时的neo4j gem，当前Neo4j官方主推的Ruby驱动已经更新，API的命名空间和用法都发生了变化。下面是具体的解决方案：

• 第一步：替换为官方驱动gem
  旧的neo4j gem（比如和ActiveNode绑定的版本）已经不再是官方推荐的连接方式，现在要用neo4j-ruby-driver。先卸载旧gem（如果已安装），再安装新驱动：

  gem uninstall neo4j
  gem install neo4j-ruby-driver
  

  要是用Bundler管理依赖，修改你的Gemfile：

  # 删掉原来的 gem 'neo4j'
  gem 'neo4j-ruby-driver'
  

  然后执行bundle install更新依赖。

• 第二步：修改连接代码
  新驱动的API和旧版本完全不同，不再使用Neo4j::Session.open，而是先创建驱动实例，再获取会话。修正后的代码示例：

  require 'neo4j-ruby-driver'
  
  # 创建驱动（推荐用bolt协议，这是Neo4j默认的高性能通信协议）
  driver = Neo4j::Driver::GraphDatabase.driver(
    'bolt://localhost:7687',
    Neo4j::Driver::AuthTokens.basic('neo4j', 'password')
  )
  
  # 获取会话
  session = driver.session
  
  # 示例：执行一个简单查询验证连接
  result = session.run('MATCH (n) RETURN count(n) AS node_count')
  result.each do |record|
    puts "数据库里共有 #{record['node_count']} 个节点"
  end
  
  # 用完记得关闭会话和驱动，避免资源泄漏
  session.close
  driver.close
  

• 额外注意事项

  • 协议与端口：你原来的代码用了http://，但bolt://是Neo4j推荐的连接方式，性能远优于HTTP；如果一定要用HTTP，端口要改成7474，驱动协议也要对应改成http://。
  • 版本兼容：确保neo4j-ruby-driver的版本和你的Neo4j服务器版本匹配，一般最新驱动支持最近几个大版本的Neo4j。

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