---
title: "HTTP 初始行最大长度配置"
date: 2026-02-11
lastmod: 2026-02-11
description: "控制 HTTP 初始行最大长度的配置说明"
tags: ["HTTP配置", "安全配置", "协议配置"]
summary: "配置项作用 #  http.max_initial_line_length 配置项指定 HTTP 初始行（请求行或状态行）的最大长度。这包括方法、URI 和 HTTP 版本（请求）或状态码和原因短语（响应）。
默认值 #  4KB 配置类型 #  静态配置
取值范围 #  支持字节单位（如 4KB, 8KB） 配置格式 #  # 默认配置 http.max_initial_line_length: 4kb # 增加限制 http.max_initial_line_length: 8kb # 减少限制 http.max_initial_line_length: 2kb  初始行内容 #  请求初始行 #  POST /my-index/_doc/_search?pretty=true HTTP/1.1 响应初始行 #  HTTP/1.1 200 OK  推荐配置 #  默认配置 #  http.max_initial_line_length: 4kb 长 URL 场景 #  # 支持更长的 URL http."
---


## 配置项作用

`http.max_initial_line_length` 配置项指定 HTTP 初始行（请求行或状态行）的最大长度。这包括方法、URI 和 HTTP 版本（请求）或状态码和原因短语（响应）。

## 默认值

```
4KB
```

## 配置类型

**静态配置**

## 取值范围

```
支持字节单位（如 4KB, 8KB）
```

## 配置格式

```yaml
# 默认配置
http.max_initial_line_length: 4kb

# 增加限制
http.max_initial_line_length: 8kb

# 减少限制
http.max_initial_line_length: 2kb
```

---

## 初始行内容

## 请求初始行

```
POST /my-index/_doc/_search?pretty=true HTTP/1.1
```

## 响应初始行

```
HTTP/1.1 200 OK
```

---

## 推荐配置

## 默认配置

```yaml
http.max_initial_line_length: 4kb
```

## 长 URL 场景

```yaml
# 支持更长的 URL
http.max_initial_line_length: 8kb
```

---

## 注意事项

1. **重启生效**：修改此配置需要重启节点
2. **URL 长度**：确保设置足够大以支持您的 URL
3. **安全性**：限制初始行长度可以防止某些恶意请求