Heroku部署中Searchkick调用本地Elasticsearch而非Bonsai环境变量问题

核心问题分析 #

明明Heroku已正确加载BONSAI_URL，但创建Contact时仍触发Faraday::ConnectionFailed错误，说明Searchkick没有正确使用Bonsai配置的Elasticsearch客户端，依然尝试连接本地默认端口9200。

解决方案 #

1. 强制Searchkick使用Bonsai客户端 #

在config/initializers/searchkick.rb中，针对生产环境明确指定Searchkick的客户端为Bonsai提供的URL：

# config/initializers/searchkick.rb
if Rails.env.production?
  Searchkick.disable_callbacks = true # 保留你已有的自动回调禁用配置
  # 直接用BONSAI_URL初始化客户端
  Searchkick.client = Elasticsearch::Client.new(
    url: ENV["BONSAI_URL"],
    retry_on_failure: true,
    transport_options: { request: { timeout: 5 } }
  )
end

如果你的bonsai.rb已经配置了Elasticsearch::Model.client，也可以让Searchkick复用这个全局客户端：

Searchkick.client = Elasticsearch::Model.client if Rails.env.production?

2. 检查模型的Searchkick配置 #

确保Contact模型中没有硬编码本地客户端配置，比如：

# app/models/contact.rb
class Contact < ApplicationRecord
  searchkick # 不要在这里指定client: 本地相关的配置
end

如果之前模型里有自定义client参数，直接移除即可。

3. 确认Initializer加载顺序 #

Bonsai的配置需要在Searchkick之前加载，否则Searchkick会使用默认的本地客户端。可以通过重命名initializer文件调整加载顺序：

• 将bonsai.rb改为01_bonsai.rb
• 将searchkick.rb改为02_searchkick.rb
  Rails会按文件名的字母/数字顺序加载initializer，确保Bonsai的客户端配置先被初始化。

4. 验证自动回调禁用的生效性 #

如果创建Contact时仍触发索引操作，说明自动回调禁用可能没生效。可以在Heroku控制台手动验证：

heroku run rails c
> Rails.env.production?
> Searchkick.disable_callbacks

如果返回false，检查searchkick.rb的配置是否被正确加载，有没有语法错误。

5. 排除Pagy扩展的干扰 #

暂时注释掉pagy/extras/elasticsearch_rails的引入，测试创建Contact是否还出现连接错误。如果问题消失，说明该扩展可能初始化了独立的Elasticsearch客户端，需要调整Pagy的配置以复用Bonsai的客户端。

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