---
title: "Search 线程池最大队列大小配置"
date: 2026-03-09
lastmod: 2026-03-09
description: "thread_pool.search.max_queue_size 配置项用于控制搜索线程池队列的最大容量。"
tags: ["线程池", "搜索", "队列管理", "ThreadPool"]
summary: "配置项作用 #  thread_pool.search.max_queue_size 配置项用于控制搜索线程池队列的最大容量。
当队列达到此大小时，新的搜索请求将被拒绝。
配置项属性 #   配置路径: thread_pool.search.max_queue_size 数据类型: Integer（整数） 默认值: 1000 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（已废弃） 废弃状态: 已废弃  配置项详解 #  工作机制 #  自动队列调整范围 队列大小动态调整: ├── 最小值: min_queue_size (1000) ├── 最大值: max_queue_size (1000) ├── 当前值: 在范围内动态调整 └-- 基于 Little's Law max_queue_size 作用: ├── 设置队列上限 ├── 防止队列无限增长 ├── 超过则拒绝新请求 └-- 保护系统资源 -1 表示: ├── 无限制队列 ├── 不自动拒绝 ├-- 可能导致内存问题 └-- 谨慎使用 与 min_queue_size 的关系 #  队列范围约束 约束条件: max_queue_size >= min_queue_size 默认配置: min = 1000 max = 1000 → 队列固定为 1000 不同配置示例: min = 500 max = 2000 → 队列在 500-2000 之间调整 min = 100 max = 100 → 队列固定为 100 配置建议 #  默认配置 #  thread_pool: search: max_queue_size: 1000 # 默认值 注意事项 #    已废弃: 配置项已废弃。"
---


## 配置项作用

`thread_pool.search.max_queue_size` 配置项用于控制**搜索线程池队列的最大容量**。

当队列达到此大小时，新的搜索请求将被拒绝。

## 配置项属性

- **配置路径**: `thread_pool.search.max_queue_size`
- **数据类型**: `Integer`（整数）
- **默认值**: `1000`
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（已废弃）
- **废弃状态**: 已废弃

## 配置项详解

## 工作机制

```
自动队列调整范围

队列大小动态调整:
├── 最小值: min_queue_size (1000)
├── 最大值: max_queue_size (1000)
├── 当前值: 在范围内动态调整
└-- 基于 Little's Law


max_queue_size 作用:
├── 设置队列上限
├── 防止队列无限增长
├── 超过则拒绝新请求
└-- 保护系统资源


-1 表示:
├── 无限制队列
├── 不自动拒绝
├-- 可能导致内存问题
└-- 谨慎使用
```

## 与 min_queue_size 的关系

```
队列范围约束

约束条件:
max_queue_size >= min_queue_size


默认配置:
min = 1000
max = 1000
→ 队列固定为 1000


不同配置示例:
min = 500
max = 2000
→ 队列在 500-2000 之间调整


min = 100
max = 100
→ 队列固定为 100
```

## 配置建议

## 默认配置

```yaml
thread_pool:
  search:
    max_queue_size: 1000  # 默认值
```

## 注意事项

1. **已废弃**: 配置项已废弃。

2. **必须大于等于 min**: max_queue_size >= min_queue_size。

3. **保护系统**: 限制队列大小防止资源耗尽。