Laravel Scout 导入 Elasticsearch 7.12.0 时遇到异常，如何解决？

Elasticsearch 导入数据时非法参数异常的诊断和解决

问题

当使用 Laravel 10 Scout（php artisan scout:import）将数据导入 Elasticsearch 7.12.0 时，你可能会遇到以下异常：

{
  "error": {
    "root_cause": [
      {
        "type": "illegal_argument_exception",
        "reason": "unknown setting [index.analysis] please check that any required plugins are installed, or check the breaking changes documentation for removed settings"
      }
    ],
    "type": "illegal_argument_exception",
    "reason": "unknown setting [index.analysis] please check that any required plugins are installed, or check the breaking changes documentation for removed settings",
    "suppressed": [
      {
        "type": "illegal_argument_exception",
        "reason": "unknown setting [index.index] did you mean any of [index.hidden, index.codec]?"
      }
    ]
  },
  "status": 400
}

此异常表明 Elasticsearch 无法识别你配置的索引设置。

诊断

导致此异常的常见原因有：

• 索引设置拼写错误或不存在： 确保索引设置拼写正确，并且在当前版本的 Elasticsearch 中可用。
• 缺少插件： 某些索引设置需要特定的插件才能工作。确认所需的插件已安装并正确配置。
• 过时的 Elasticsearch 版本： 某些索引设置在较新的版本中被删除或重命名。更新到最新版本的 Elasticsearch 可能解决问题。

解决方法

1. 检查索引设置： 仔细检查索引设置，确保拼写正确并存在于当前版本的 Elasticsearch 中。

2. 检查插件： 验证已安装并配置所需的插件。有关插件安装和配置的说明，请参阅 Elasticsearch 文档。

3. 更新 Elasticsearch： 如果使用的是旧版本的 Elasticsearch，请更新到最新版本以获取最新的设置和修复程序。

4. 禁用不必要的设置： 如果某些设置不必要，可以考虑禁用它们。例如，index.analysis 设置可以通过将 index.mapping.ignore_malformed 设置为 true 来禁用。

5. 联系 Elasticsearch 支持： 如果上述步骤无法解决问题，请联系 Elasticsearch 支持团队寻求进一步帮助。

结论

非法参数异常可能令人沮丧，但通常可以通过检查索引设置、插件和 Elasticsearch 版本来解决。通过仔细诊断和采取适当的措施，你可以成功将数据导入 Elasticsearch。

常见问题解答

1. 如何确定所需的插件？

通过查看 Elasticsearch 文档或错误消息中提到的插件名称可以确定所需的插件。

2. 如何更新 Elasticsearch 版本？

更新 Elasticsearch 的过程取决于你的系统。请参阅官方文档了解详细说明。

3. 如何禁用索引设置？

通过设置与所需索引设置对应的负值（例如 index.analysis.enabled: false）可以禁用索引设置。

4. 为什么会在导入数据时出现此异常？

此异常通常发生在索引设置拼写错误、缺少插件或使用过时版本的 Elasticsearch 时。

5. 如何避免此异常？

通过在导入数据之前创建索引并设置正确的索引设置，可以避免此异常。