【Solr现网问题】索引文档数量超限

秒速五厘米 2022-03-16 15:22 286阅读 0赞

## 概念解释 ##

Too many documents具体是指什么？索引数？索引文档数？

## 异常信息 ##

在splitShard时，报错如下：

Caused by: org.apache.lucene.index.CorruptIndexException: Too many documents: an index cannot exceed 2147483519 but readers have total maxDoc=2147483529 
    	at org.apache.lucene.index.BaseCompositeReader.<init>(BaseCompositeReader.java:83)
    	at org.apache.lucene.index.DirectoryReader.<init>(DirectoryReader.java:342)
    	at org.apache.lucene.index.StandardDirectoryReader.<init>(StandardDirectoryReader.java:45)
    	at org.apache.lucene.index.StandardDirectoryReader.open(StandardDirectoryReader.java:120)
    	at org.apache.lucene.index.IndexWriter.getReader(IndexWriter.java:460)
    	at org.apache.lucene.index.StandardDirectoryReader.doOpenFromWriter(StandardDirectoryReader.java:291)
    	at org.apache.lucene.index.StandardDirectoryReader.doOpenIfChanged(StandardDirectoryReader.java:276)
    	at org.apache.lucene.index.DirectoryReader.openIfChanged(DirectoryReader.java:235)
    	at org.apache.solr.core.SolrCore.openNewSearcher(SolrCore.java:1759)
    	... 19 more
     | org.apache.solr.common.SolrException.log(SolrException.java:159)

## 定位分析 ##

Although a Solr implementation can scale into the billions of documents by using a number of shards, each individual shard or Solr core is limited by the Lucene limit for an index which is approximately 2.14 billion documents (2147483519 to be exact) in the current implementation of Lucene.  
[https://issues.apache.org/jira/browse/SOLR-3504][https_issues.apache.org_jira_browse_SOLR-3504]  
[https://issues.apache.org/jira/browse/SOLR-3505][https_issues.apache.org_jira_browse_SOLR-3505]  
[https://issues.apache.org/jira/browse/SOLR-6065][https_issues.apache.org_jira_browse_SOLR-6065]  
[https://issues.apache.org/jira/browse/LUCENE-5843][https_issues.apache.org_jira_browse_LUCENE-5843]  
[https://issues.apache.org/jira/browse/LUCENE-6299][https_issues.apache.org_jira_browse_LUCENE-6299]

## 解决方案 ##

1.  查看Lucene源码，得知BaseCompositeReader类存在对当前索引总量的校验。

if (maxDoc > IndexWriter.getActualMaxDocs()) {
      if (this instanceof DirectoryReader) {
        // A single index has too many documents and it is corrupt (IndexWriter prevents this as of LUCENE-6299)
        throw new CorruptIndexException("Too many documents: an index cannot exceed " + IndexWriter.getActualMaxDocs() + " but readers have total maxDoc=" + maxDoc, Arrays.toString(subReaders));
      } else {
        // Caller is building a MultiReader and it has too many documents; this case is just illegal arguments:
        throw new IllegalArgumentException("Too many documents: composite IndexReaders cannot exceed " + IndexWriter.getActualMaxDocs() + " but readers have total maxDoc=" + maxDoc);
      }
    }

1.  修改Lucene源码IndexWriter.java，重新编译lucene-core-6.2.0.jar包。

public static final int MAX_DOCS = Integer.MAX_VALUE - 128;

将单shard索引上限调整为30亿，暂时规避数量校验：

public static final int MAX_DOCS = Integer.valueOf(System.getProperty("solr.docs.max.limit", "3000000000"));

1.  替换所在实例的lucene-core-6.2.0.jar包，重启Solr实例。
2.  实例状态稳定之后，进行split shard分裂。
3.  最后将jar包回退，问题解决。

## 注意事项 ##

1.  索引过大的时候，对索引进行分裂操作推荐在服务器空闲时进行，因为split shard会进行大量的io读写操作，索引的分裂和复制涉及大量读写，而且当原shard有多个复制节点的时候，split也会生成同样多的复制节点，这些节点的数据是需要从leader同步的，索引很大或者replica过多的情况下会耗费大量的网络资源。
2.  替换客户生产集群的jar包时，我劝你一定要谨慎：由于涉及到历史版本，一定要仔细比对代码改动量，最好取下老的jar包进行反编译比对IndexWriter.java代码，确保改动范围，避免引出二次事故。

## 建议方案 ##

1.  对索引状态进行监控，预警，及时分裂，避免单个索引承载过多文档数。
2.  查看索引状态可以根据Lucene提供的工具类CheckIndex来查看，见如下资料。

## Reference ##

[https://blog.csdn.net/shirdrn/article/details/9770829][https_blog.csdn.net_shirdrn_article_details_9770829]  
[http://www.it610.com/article/2134736.htm][http_www.it610.com_article_2134736.htm]  
[https://blog.csdn.net/jayson1001/article/details/78228699][https_blog.csdn.net_jayson1001_article_details_78228699]

[https_issues.apache.org_jira_browse_SOLR-3504]: https://issues.apache.org/jira/browse/SOLR-3504
[https_issues.apache.org_jira_browse_SOLR-3505]: https://issues.apache.org/jira/browse/SOLR-3505
[https_issues.apache.org_jira_browse_SOLR-6065]: https://issues.apache.org/jira/browse/SOLR-6065
[https_issues.apache.org_jira_browse_LUCENE-5843]: https://issues.apache.org/jira/browse/LUCENE-5843
[https_issues.apache.org_jira_browse_LUCENE-6299]: https://issues.apache.org/jira/browse/LUCENE-6299
[https_blog.csdn.net_shirdrn_article_details_9770829]: https://blog.csdn.net/shirdrn/article/details/9770829
[http_www.it610.com_article_2134736.htm]: http://www.it610.com/article/2134736.htm
[https_blog.csdn.net_jayson1001_article_details_78228699]: https://blog.csdn.net/jayson1001/article/details/78228699