从Elasticsearch迁移到AWS OpenSearch后报Invalid or missing tagline错如何解决？

报错触发原因 #

Elasticsearch 官方的 Rest High Level Client 在和服务端建立连接的握手阶段，会强制校验服务端返回的标识字段 tagline 必须为固定值 You Know, for Search，校验不通过就会抛出对应异常。
而 OpenSearch 作为 Elasticsearch 更改开源协议后的衍生分支，将默认返回的 tagline 调整为了 The OpenSearch Project: https://opensearch.org/，AWS 托管的 OpenSearch 服务沿用了该默认配置，和 ES 客户端的校验逻辑冲突，因此触发了该报错。

对应解决方案 #

• 方案1：替换为 OpenSearch 官方兼容客户端
  将项目依赖的 elasticsearch-rest-high-level-client 替换为 OpenSearch 官方提供的 opensearch-rest-high-level-client，该客户端原生适配 OpenSearch 服务端，同时保留了和 ES 客户端高度一致的 API 定义，仅需要修改依赖声明和初始化逻辑，不需要大幅调整业务代码，是兼容性最好的长期方案。
• 方案2：自定义拦截器修改响应绕开校验（仅适用于7.x系列ES客户端）
  针对7.x版本的 ES Rest High Level Client，可以自行实现 HTTP 响应拦截器，在客户端解析服务端响应前，将返回的 OpenSearch 专属 tagline 替换为 ES 客户端期望的 You Know, for Search，绕开校验逻辑。该方案属于临时兼容方案，高版本ES客户端可能已关闭自定义修改响应的入口，不建议长期使用。
• 方案3：修改 OpenSearch 服务端 tagline 配置
  如果使用的是自行部署的 OpenSearch 集群，可以在配置文件中添加 opensearch.tagline: "You Know, for Search"，重启集群后即可适配 ES 客户端的校验规则。如果使用的是 AWS 托管 OpenSearch 服务，可以在控制台的高级配置项中查找对应参数修改，若平台不支持自定义该配置则无法使用该方案。
• 方案4：降级 ES 客户端版本至7.10.2及以下
  Elasticsearch 7.10.2 是更改开源协议前的最后一个公开版本，该版本的 Rest High Level Client 不存在 tagline 强校验逻辑，可直接兼容 OpenSearch 1.x、2.x 系列的所有版本，适合不想调整依赖结构的短期项目使用。

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