数字档案馆系统组合检索功能搭建与实操配置全步骤指南

一、前置环境准备

所有依赖均提供精准下载地址，无需自行查找：

• 基础运行环境：JDK11，下载地址 https://adoptium.net/zh-CN/temurin/releases/?version=11
• 元数据存储：MySQL8.0，数字档案馆基础框架采用RuoYi-Vue，下载地址 https://gitee.com/y_project/RuoYi-Vue
• 检索核心服务：ElasticSearch7.17.0，下载地址 https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.0-linux-x86_64.tar.gz
• 中文分词插件：IK分词器7.17.0，下载地址 https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.17.0/elasticsearch-analysis-ik-7.17.0.zip

IK分词器版本必须和ES版本完全一致，否则会导致ES启动失败；ES禁止用root账户启动，需提前新建普通用户并给ES目录授权。

二、检索核心服务配置

2.1 ES基础配置

解压ES安装包后，修改config/elasticsearch.yml文件，完整可复制配置如下：

```yaml cluster.name: archive-es node.name: archive-es-node-1 network.host: 0.0.0.0 http.port: 9200 discovery.type: single-node xpack.security.enabled: false http.cors.enabled: true http.cors.allow-origin: "" ```

将IK分词器压缩包解压到ES的plugins目录下，新建ik文件夹存放所有解压后的文件，重启ES服务，执行curl http://localhost:9200/_cat/plugins，返回ik即配置成功。

2.2 档案索引创建

用Postman或Kibana向ES发送PUT请求创建档案专属索引，完整请求如下：

```json PUT /archive_index { "settings": { "number_of_shards": 3, "number_of_replicas": 1, "analysis": { "analyzer": { "ik_smart_analyzer": { "tokenizer": "ik_smart" }, "ik_max_word_analyzer": { "tokenizer": "ik_max_word" } } } }, "mappings": { "properties": { "id": {"type": "long"}, "archive_code": {"type": "keyword"}, "title": {"type": "text", "analyzer": "ik_max_word_analyzer", "search_analyzer": "ik_smart_analyzer"}, "author": {"type": "text", "analyzer": "ik_smart_analyzer"}, "create_date": {"type": "date", "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd"}, "retention_period": {"type": "keyword"}, "fonds_code": {"type": "keyword"}, "catalog_code": {"type": "keyword"}, "full_content": {"type": "text", "analyzer": "ik_max_word_analyzer", "search_analyzer": "ik_smart_analyzer"} } } } ```

请求返回{"acknowledged":true,"shards_acknowledged":true,"index":"archive_index"}即创建成功。

三、后端组合检索接口开发

基于SpringBoot框架开发，先引入ES依赖，完整maven坐标如下：

```xml org.springframework.boot spring-boot-starter-data-elasticsearch 2.7.14 ```

在application.yml添加ES配置：

```yaml spring: elasticsearch: uris: http://localhost:9200 connection-timeout: 5000 socket-timeout: 30000 ```

核心检索服务层完整可复制代码如下，支持任意字段组合检索：

```java @Service public class ArchiveSearchService { @Resource private ElasticsearchRestTemplate elasticsearchRestTemplate; public PageResult combinationSearch(ArchiveSearchReq req) { BoolQueryBuilder boolQuery = QueryBuilders.boolQuery(); // 题名模糊匹配（可选） if (StrUtil.isNotBlank(req.getTitle())) { boolQuery.must(QueryBuilders.matchQuery("title", req.getTitle())); } // 责任者匹配（可选） if (StrUtil.isNotBlank(req.getAuthor())) { boolQuery.must(QueryBuilders.matchQuery("author", req.getAuthor())); } // 成文日期范围筛选（可选） if (req.getStartDate() != null && req.getEndDate() != null) { boolQuery.must(QueryBuilders.rangeQuery("create_date") .gte(req.getStartDate()).lte(req.getEndDate())); } // 全文内容匹配（可选） if (StrUtil.isNotBlank(req.getFullContent())) { boolQuery.must(QueryBuilders.matchQuery("full_content", req.getFullContent())); } // 档号/全宗号精确匹配（可选） if (StrUtil.isNotBlank(req.getArchiveCode())) { boolQuery.must(QueryBuilders.termQuery("archive_code", req.getArchiveCode())); } if (StrUtil.isNotBlank(req.getFondsCode())) { boolQuery.must(QueryBuilders.termQuery("fonds_code", req.getFondsCode())); } // 分页查询 NativeSearchQuery query = new NativeSearchQueryBuilder() .withQuery(boolQuery) .withPageable(PageRequest.of(req.getPageNum() - 1, req.getPageSize())) .withSort(SortBuilders.fieldSort("create_date").order(SortOrder.DESC)) .build(); SearchHits searchHits = elasticsearchRestTemplate.search(query, ArchiveDoc.class); List list = searchHits.get().map(SearchHit::getContent).collect(Collectors.toList()); return new PageResult<>(list, searchHits.getTotalHits(), req.getPageSize(), req.getPageNum()); } } ```

所有检索字段均支持非必填任意组合，无需额外配置即可实现多条件逻辑与匹配，完全满足数字档案馆组合检索业务需求。

四、前端检索交互实现

基于Vue2+ElementUI实现组合检索表单，完整可复制代码如下：

```vue ```

五、效果验证与问题排查

5.1 功能验证步骤

• 批量导入100条测试档案数据到ES索引，确保各字段值覆盖不同场景
• 单条件测试：只输入题名关键词，验证返回结果是否均包含对应关键词
• 组合条件测试：同时输入题名关键词、日期范围、档号，验证返回结果是否同时满足所有输入的条件
• 全文检索测试：输入档案正文中的关键词，验证是否能匹配到对应档案

5.2 常见问题排查

• 检索不到匹配结果：访问http://localhost:9200/archive_index/_analyze，输入检索关键词测试分词是否正常，若返回空则IK分词器安装失败
• 日期格式报错：检查ES索引mapping的date格式是否和导入数据的日期格式完全匹配，不匹配需修改mapping后重新导入数据
• 检索结果不全：检查boolQuery逻辑，必须同时满足的条件需放在must下，可选满足的条件放在should下，逻辑错误会导致结果遗漏