Solr原子更新失效：批量操作未按预期执行

我来帮你分析下你遇到的问题，结合Solr 8.0.0的特性和常见坑点，主要有几个关键原因和解决步骤：

1. 批量请求的JSON格式错误（最可能的元凶） #

你提交的批量请求存在一个致命的JSON语法问题：单个JSON对象中重复使用了"add"键。JSON规范里，同一对象内的重复键会被解析器覆盖，也就是说你的请求里只有最后一个add操作会被Solr处理，前面的所有更新都被直接忽略了！这就是为什么看起来“偶尔生效”——如果某次请求只有一条记录就正常，多条时只有最后一条生效，导致你误以为功能不稳定。

正确的批量更新格式 #

Solr的批量更新需要将每个操作（add/commit/delete）放在顶层数组中，示例如下：

[
  { 
    "add": { 
      "overwrite": true, 
      "doc": { 
        "subscriptions": { "remove": ["aliases/nBro7MgwqMeMHFm2Z1sSYzVqL21DxJtR"] }, 
        "id": "messages/NbRkzeqngmLF2D32WdjDmaYzNqMh2VkG" 
      } 
    }
  },
  { 
    "add": { 
      "overwrite": true, 
      "doc": { 
        "subscriptions": { "remove": ["aliases/nBro7MgwqMeMHFm2Z1sSYzVqL21DxJtR"] }, 
        "id": "messages/S6AZ602Vz4EAgdcqCZSnkXGEcDKC2puL" 
      } 
    }
  },
  { 
    "add": { 
      "overwrite": true, 
      "doc": { 
        "subscriptions": { "remove": ["aliases/nBro7MgwqMeMHFm2Z1sSYzVqL21DxJtR"] }, 
        "id": "messages/OeyOtZApaJglZ3XgU7uq2o49S7GydCzw" 
      } 
    }
  },
  { "commit": {} }
]

2. 检查subscriptions字段的Schema配置 #

Atomic Updates对多值字段的操作有严格的Schema要求，确保你的字段满足：

• 设置multiValued="true"（必须，因为你要操作数组元素）
• 设置stored="true"或useDocValuesAsStored="true"（Solr需要读取现有字段值来执行remove/add-distinct操作）
• 字段类型支持Atomic操作：比如StrField、TextField（避免使用一些特殊的自定义类型）

示例Schema配置片段：

<field name="subscriptions" type="string" multiValued="true" stored="true" docValues="true"/>

3. add-distinct重复插入的问题 #

对于add-distinct操作，除了确保请求格式正确外，还要注意：

• Solr 8.0.0属于早期版本，存在一些关于多值字段add-distinct的已知bug（比如重复值处理逻辑问题），建议升级到8.x系列的稳定版本（比如8.11.2，这是8.x的最终稳定版），很多这类问题在后续版本中已经修复。
• 确认你使用的add-distinct语法正确：应该是"subscriptions": { "add-distinct": ["new-alias"] }，不要误写成普通的add操作。

4. 额外排查点 #

• 并发冲突：如果有其他请求同时修改同一个文档，可能会导致更新被覆盖，可以检查Solr的日志（solr.log）是否有并发更新的警告。
• Commit生效时机：虽然你的请求里包含commit，但在SolrCloud环境下，分布式commit可能有短暂延迟，可以尝试添加waitSearcher="true"确保commit完成后再返回：{ "commit": { "waitSearcher": true } }

按照上面的步骤先修正请求格式，再检查Schema，应该能解决大部分“不稳定”的问题。如果升级版本后add-distinct仍有问题，可以进一步排查字段类型和Solr日志的细节。

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