如何用Rspec编写Elasticsearch测试用例？索引字段自动生成问题

嘿，我之前也碰到过一模一样的问题——本地用TestCluster跑测试时，总是没法像cloud.elastic.co的托管集群那样自动生成name.keyword这类keyword子字段，导致测试和生产环境的索引结构不一致，各种报错。给你几个实用的解决思路：

1. 显式在模型里定义映射（最稳妥的方案） #

托管集群的默认动态映射会自动给text字段添加上keyword子字段，但TestCluster默认没开这个规则。最靠谱的办法就是在你的Building模型里明确定义映射，让测试和生产环境保持一致：

# app/models/building.rb
mapping do
  indexes :name, type: 'text' do
    indexes :keyword, type: 'keyword', ignore_above: 256
  end
  # 其他字段也可以按这个格式定义
end

这样不管是生产集群还是测试集群，索引结构都会完全一致，从根源上避免环境差异带来的问题。

2. 启动TestCluster时配置默认动态映射规则 #

如果你不想手动给每个字段写映射，可以在启动TestCluster的时候，把集群的默认动态映射配置成和托管集群一样的规则：

# 比如放在spec/support/elasticsearch.rb这类测试支持文件里
Elasticsearch::Extensions::TestCluster.start(
  port: 9250, # 自定义测试端口避免冲突
  number_of_nodes: 1,
  cluster_settings: {
    index: {
      mapping: {
        dynamic_templates: [
          {
            strings_to_text_and_keyword: {
              match_mapping_type: 'string',
              mapping: {
                type: 'text',
                fields: {
                  keyword: {
                    type: 'keyword',
                    ignore_above: 256
                  }
                }
              }
            }
          }
        ]
      }
    }
  }
)

这个配置会让TestCluster自动给所有string类型的字段生成对应的keyword子字段，和cloud.elastic.co的默认行为完全对齐。

3. 导入生产环境的映射到测试集群 #

如果你的生产环境已经有成熟的索引映射，可以先把它导出成JSON文件，然后在测试初始化的时候加载到TestCluster里：

# 在测试的setup阶段执行
client = Elasticsearch::Client.new(host: Elasticsearch::Extensions::TestCluster.hosts.first)
# 假设你已经把生产映射导出到spec/fixtures/elasticsearch/buildings_mapping.json
mapping_json = File.read(Rails.root.join('spec/fixtures/elasticsearch/buildings_mapping.json'))
client.indices.create(index: 'buildings', body: JSON.parse(mapping_json))

这种方式能100%保证测试环境和生产环境的映射一致，适合字段比较多、不想逐个定义的场景。

另外提个小提醒：要确保你本地用的elasticsearch-ruby版本和生产环境一致，毕竟Ruby 2.3.1和Rails 5.0.3都是比较老的版本，版本不兼容也可能导致奇怪的问题。

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