Rails中使用Searchkick按布尔字段查询无结果的问题

问题背景 #

使用Searchkick查询verified: true的用户时，多次尝试不同查询语法均返回空结果，尽管数据库中存在符合条件的用户。相关代码如下：

User模型代码 #

class User < ApplicationRecord
  searchkick

  # Indexed data
  def search_data
    {
      email: email,
      verified: verified,
      created_at: created_at,
      updated_at: updated_at,
    }
  end
end

尝试过的查询语句及结果 #

results = User.search("*", where: { verified: true })
results.response
{"took"=>0, "timed_out"=>false, "_shards"=>{"total"=>1, "successful"=>1, "skipped"=>0, "failed"=>0}, "hits"=>{"total"=>{"value"=>0, "relation"=>"eq"}, "max_score"=>nil, "hits"=>[]}}

# 变体查询
results = User.search('*', :where=>{:verified=>[true]})
results = User.search('*', :where=>{:verified=>[1]})
results = User.search('*', :where=>{:verified=>["1"]})
results = User.search('*', :where=>{:verified=>["true"]})

解决步骤 #

1. 检查Elasticsearch索引的字段映射 #

首先确认Elasticsearch中verified字段的类型是否为boolean。执行以下命令（替换为你的Elasticsearch地址和索引名，默认索引名为users）：

curl -X GET http://localhost:9200/users/_mapping

如果返回的映射中verified字段类型不是boolean，说明索引时字段类型识别错误，需要显式指定。

2. 显式定义字段映射类型 #

修改User模型，通过searchkick mappings配置显式指定verified为布尔类型，确保索引时字段类型正确：

class User < ApplicationRecord
  searchkick mappings: {
    user: {
      properties: {
        verified: { type: "boolean" },
        email: { type: "text" },
        created_at: { type: "date" },
        updated_at: { type: "date" }
      }
    }
  }

  def search_data
    {
      email: email,
      verified: verified,
      created_at: created_at,
      updated_at: updated_at,
    }
  end
end

3. 彻底重建索引 #

删除旧索引并重新生成，确保新的映射生效：

# 删除现有索引
User.searchkick_index.delete
# 重新索引所有用户
User.reindex

注意：删除索引会清空现有索引数据，操作前确认数据库中的用户数据可以重新生成索引。

4. 确保search_data中返回正确的布尔值 #

部分情况下，ActiveRecord的布尔字段可能在序列化时返回1/0而非true/false，可以在search_data中强制转换：

def search_data
  {
    email: email,
    verified: verified == true, # 确保值为布尔类型
    created_at: created_at,
    updated_at: updated_at,
  }
end

完成以上步骤后，再执行原查询语句User.search("*", where: { verified: true })即可得到预期结果。

内容的提问来源于stack exchange，提问作者Carlos Gómez