Rails7+WSL环境下ElasticSearch启动失败及联系人操作报错

在WSL Ubuntu环境下基于Ruby on Rails 7开发，引入了searchkick、elasticsearch gems，同时安装了TomSelect，遇到以下问题：

遇到的问题 #

• 执行命令sudo service elasticsearch start时，返回错误：elasticsearch: unrecognized service；
• 联系人页面导航栏的搜索功能可正常使用，但提交“新建联系人”表单时频繁出现Faraday错误：Failed to open TCP connection to localhost:9200 (Connection refused - connect(2) for 127.0.0.1:9200)，部分联系人仍能成功保存；
• 有时表单完全无法提交，无JS错误、无网络请求记录，提交按钮无响应。

解决方案 #

1. 解决Elasticsearch服务无法识别的问题 #

你通过Gemfile安装的是Elasticsearch的Ruby客户端，不是Elasticsearch服务本身，系统自然找不到对应服务。在WSL Ubuntu中需单独安装Elasticsearch服务：

1. 导入Elasticsearch GPG密钥：

   wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg
   

2. 添加Elasticsearch源：

   echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic.list
   

3. 更新包列表并安装Elasticsearch：

   sudo apt update && sudo apt install elasticsearch
   

4. 启动并设置开机自启：

   sudo systemctl daemon-reload
   sudo systemctl enable elasticsearch
   sudo systemctl start elasticsearch
   

5. 验证服务状态：

   curl http://localhost:9200
   

   返回包含Elasticsearch版本信息的JSON则说明启动成功。

2. 解决Faraday连接拒绝错误 #

该错误是因为SearchKick尝试连接本地9200端口的Elasticsearch服务，但服务未运行或配置异常：

• 确保上述步骤中Elasticsearch服务已正常启动；
• 在Rails配置文件（config/application.rb或config/environments/development.rb）中添加SearchKick配置，明确指定Elasticsearch地址：

  Searchkick.client = Elasticsearch::Client.new(host: 'http://localhost:9200')
  

• 若WSL中Elasticsearch绑定地址并非127.0.0.1，修改/etc/elasticsearch/elasticsearch.yml中的network.host为0.0.0.0或127.0.0.1，之后重启服务：

  sudo systemctl restart elasticsearch
  

• 部分联系人能保存是因为Rails数据库操作与Elasticsearch索引默认异步执行，数据库保存成功但索引失败，解决服务问题后即可同步索引。

3. 解决表单无法提交的问题 #

该问题大概率与TomSelect或前端表单事件冲突有关：

• 检查TomSelect初始化代码，确认未阻止表单默认提交事件（比如误用preventDefault()却未处理提交逻辑）；
• 查看浏览器控制台的警告信息，TomSelect可能存在初始化失败或DOM元素找不到的情况，进而影响表单提交；
• 临时禁用TomSelect，测试表单是否能正常提交，确认是否为TomSelect导致的问题；
• 检查表单HTML结构，确保提交按钮的type属性为submit，而非button或其他类型；
• 若使用Rails 7默认的Turbo，可尝试在表单标签添加data-turbo="false"测试是否为Turbo拦截导致：

  <%= form_with(model: @contact, data: { turbo: "false" }) do |form| %>
  

额外优化建议 #

• 若不想本地安装Elasticsearch服务，可使用Docker快速运行：

  docker run -d -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" elasticsearch:8.x
  

• 为避免Elasticsearch服务未运行时影响业务逻辑，可在config/initializers/searchkick.rb中配置索引失败不抛出异常：

  Searchkick.raise_on_failure = false
  

• 你的Contact模型同时使用了Ransack和SearchKick，当前导航栏搜索用的是Ransack（数据库搜索），所以Elasticsearch未运行也能工作。若要切换为SearchKick搜索，修改index方法：

  def index
    @contacts = current_user.contacts
    if params[:search].present?
      @results = @contacts.search(params[:search], fields: [:first_name, :last_name])
    else
      @results = @contacts.all
    end
  

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