Solr 8.7开启认证后上传configset为空、集合无配置问题

已确认的操作与异常现象 #

• 本地打包配置：执行命令 (cd /disk/configsets/my-collection/conf && zip -r - *) > my-collection.zip，本地解压验证压缩包结构符合预期，顶层直接存放solrconfig.xml及其他所需配置文件，无多余嵌套目录
• Configset上传ZooKeeper：执行带BasicAuth认证的curl上传命令 curl -X POST --header "Content-Type:application/octet-stream" --user userSolr:pwdSolr --data-binary @my-collection.zip "http://host:port/solr/admin/configs?action=UPLOAD&name=my-collection"
• 创建关联Collection：执行带认证的curl命令 curl -X POST --header "Content-Type:application/octet-stream" --user userSolr:pwdSolr "http://host:port/solr/admin/collections?action=CREATE&name=my-collection&numShards=1&replicationFactor=1&createNodeSet=localhost:8081_solr&collection.configName=my-collection"
• 异常表现：Solr UI可正常展示上传的Configset条目、可完成Collection创建流程，但进入Collection的文件配置板块无任何内容，实际关联的Configset存储为空。

核心成因与排查方向 #

• 压缩包结构与通配符打包偏差
  • 通配符*在bash环境下默认不会匹配以半角点开头的隐藏配置文件，会导致关键配置缺失
  • 需排查Solr解压上传的压缩包时，是否出现路径嵌套问题：如果压缩包内多嵌套一层conf目录，Solr会将所有文件存入ZK/configs/[configset名称]/conf路径下，而Solr默认读取的Configset路径为Configset根目录，就会表现为配置为空。可直接通过ZK客户端拉取/configs/my-collection路径的节点列表校验，不依赖UI展示
• 上传请求的响应与权限假成功
  • 目前使用的curl命令默认不校验接口返回状态，即使上传请求被认证插件拦截、ZooKeeper写入权限不足、接口抛出500类错误，命令依然会正常退出，给人“上传成功”的错觉
  • 需在上传命令中增加-v参数查看完整返回体，确认接口返回success标识为true，无403权限错误、500服务端错误
• 同名Configset的默认冲突规则
  • Solr 8.7的Configset UPLOAD接口默认不覆盖已存在的同名Configset，如果ZK中已存在同名的空Configset节点，上传的压缩包内容会被直接忽略，不会写入任何文件。需在上传请求URL中增加&overwrite=true参数强制覆盖已有配置
• 名称大小写匹配偏差
  • Solr基于ZooKeeper存储Configset，路径对大小写严格敏感，如果上传时定义的Configset名称与创建Collection时指定的collection.configName参数存在大小写差异，Collection会自动关联到Solr内置的默认配置集，表现和上传的空Configset完全一致
• 认证插件的权限范围缺失
  • 仅配置BasicAuth的接口访问权限不足以完成Configset上传，需确认对应账号拥有/configs路径下的ZooKeeper节点写入权限，部分场景下权限插件会拦截写入请求但返回成功的假响应，最终造成空配置的现象

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