Question 1

如何修复从源代码构建OpenSearch时遇到的'protoc'未找到错误？

Accepted Answer

构建需要Protocol Buffers编译器（protoc）。请在您的环境中安装protoc：在Ubuntu/Debian上，运行'sudo apt-get install protobuf-compiler'；在macOS上，使用'brew install protobuf'；对于GitHub Actions，添加使用'setup-protoc'操作的步骤。或者，对于仅使用Java的构建，gradle插件会自动管理protoc。

Question 2

在OpenSearch 3.3.0+中，当与composite聚合一起使用时，为什么scripted_metric聚合会抛出NullPointerException？

Accepted Answer

这是一个已知的回归问题（issue #21507），由OpenSearch 3.3.0–3.5.0中的PR #19006引入。当scripted_metric子聚合位于composite聚合内部时，会在所有分片上因NullPointerException失败，因为空分片的bucket结果可能为null，而代码在空检查之前解引用了result.getClass()。临时解决方案：(1)降级到3.2.0或更早版本，(2)避免在composite内部使用scripted_metric，或(3)修改你的combine_script，使其返回一个非null的默认值（例如 `return state == null ? 0 : state.n`），这样就不会产生null结果。关注该问题以获取永久修复。

Question 3

如何修复 OpenSearch 中恶意的 jqwik 1.10.0 提示注入依赖？

Accepted Answer

OpenSearch 在当前配置下不受已报告的 jqwik 问题影响。`jqwik` 仅在 `sandbox/plugins/analytics-backend-datafusion/build.gradle` 中作为仅测试用途的 `propertyTestImplementation` 依赖使用；它不包含在生产运行时中。当前锁定的版本为 `1.9.2`，`1.9.3` 同样不受影响。隐藏的 ANSI 转义提示注入首次出现在 `1.10.x` 发布系列中。

缓解措施：
1. 不要升级到 `net.jqwik:jqwik:1.10.0` 或更高的 `1.10.x` 版本。
2. 将依赖锁定在不受影响的版本，例如：
   `propertyTestImplementation 'net.jqwik:jqwik:1.9.3'`
3. 使用以下命令验证解析出的版本：
   `./gradlew :sandbox:plugins:analytics-backend-datafusion:dependencies | grep -i jqwik`
4. 如果 AI 编码代理会处理测试日志，请剥离或阻止 ANSI 转义序列，并将日志文本视为不可信数据而非指令。
5. 拉取与 PR #21906 关联的 OpenSearch 构建变更，该变更已解决此跟踪问题。

Question 4

为什么 OpenSearch bitmap terms lookup 在与 filter 和 text match 组合使用时,在多 segment 索引上返回 0 个命中?

Accepted Answer

这是一个搜索 bug，会影响使用 `value_type: "bitmap"` 的 `terms` 查找：当查询同时包含另一个 filter 子句以及跨多个 segment 的分析型 `match` 查询时，即会触发。作为变通方法，可将受影响的索引强制合并为一个 segment：

```
POST /index_main/_forcemerge?max_num_segments=1
```

合并完成后，再次运行相同的查询。其他临时变通方法包括：将文本查询移至 `post_filter`、使用 `wildcard`/`prefix` 代替分析型 `match`，或者用显式的 `terms` 数组替换 bitmap 查找。永久修复正在 OpenSearch PR #21815 中跟踪；请在包含该 PR 的版本发布后及时升级。

Question 5

如何修复 OpenSearch 分析流程中不稳定的 SearchCancellationIT 失败？

Accepted Answer

该不稳定（flaky）问题是由死锁引起的，已在 OpenSearch PR #21771 中修复。SearchCancellationIT 测试已在 PR #21730 中重新启用。请更新你的分支或构建以包含 PR #21771（以及来自 #21730 的测试重新启用），然后重新运行集成测试。作为临时解决办法，重新运行 CI 任务可能会通过，但彻底的修复方法是纳入该死锁修复。

OpenSearch

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐