ngx_http_send_header

最新推荐文章于 2025-09-29 22:12:34 发布

原创最新推荐文章于 2025-09-29 22:12:34 发布 · 925 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#nginx

src\http\ngx_http_core_module.c

ngx_int_t
ngx_http_send_header(ngx_http_request_t *r)
{
    if (r->post_action) {
        return NGX_OK;
    }

    if (r->header_sent) {
        ngx_log_error(NGX_LOG_ALERT, r->connection->log, 0,
                      "header already sent");
        return NGX_ERROR;
    }

    if (r->err_status) {
        r->headers_out.status = r->err_status;
        r->headers_out.status_line.len = 0;
    }

    return ngx_http_top_header_filter(r);
}

函数概述

ngx_http_send_header 是 Nginx HTTP 核心模块中的一个关键函数，负责发送 HTTP 响应头。
该函数的主要任务是：

检查是否允许发送 HTTP 头
处理错误状态码
触发 HTTP 头部过滤链

函数参数

ngx_int_t ngx_http_send_header(ngx_http_request_t *r)

r：指向 ngx_http_request_t 结构体的指针，包含当前 HTTP 请求的所有信息（如请求头、响应头、连接状态等）。

检查 `post_action`

if (r->post_action) {
    return NGX_OK;
}

作用：检查请求是否设置了 post_action（请求处理完成后的回调操作）。
逻辑：
- 如果设置了 post_action，说明 Nginx 需要在请求结束后执行某些额外操作（如重定向、日志记录等），此时不发送 HTTP 头，直接返回 NGX_OK。
- 这是因为 post_action 通常用于请求结束后的特殊处理，发送 HTTP 头可能会干扰后续逻辑。
意义：避免在需要后续处理的情况下提前发送 HTTP 头，保证 Nginx 的灵活性。

检查 `header_sent`

if (r->header_sent) {
    ngx_log_error(NGX_LOG_ALERT, r->connection->log, 0,
                  "header already sent");
    return NGX_ERROR;
}

作用：检查 HTTP 头是否已经发送过。
逻辑：
- 如果 header_sent 为真，说明 HTTP 头已经发送过，此时再次调用该函数属于协议错误。
- 记录 ALERT 级别的错误日志（header already sent），并返回 NGX_ERROR。
意义：
- HTTP 协议规定，响应头只能发送一次，重复发送会导致客户端解析错误。
- 该检查确保 Nginx 不会违反 HTTP 协议，提高稳定性。

处理 `err_status`

if (r->err_status) {
    r->headers_out.status = r->err_status;
    r->headers_out.status_line.len = 0;
}

作用：如果请求发生错误，设置正确的 HTTP 状态码。
逻辑：
- 如果 err_status 非零（如 404 Not Found、500 Internal Server Error），则覆盖 headers_out.status（默认状态码）。
- 将 status_line.len 设为 0，表示使用 Nginx 默认的状态描述（如 404 → "Not Found"）。
意义：
- 确保错误请求返回正确的 HTTP 状态码。
- status_line.len = 0 让 Nginx 自动填充标准状态描述，避免手动构造错误信息。

调用头部过滤链

return ngx_http_top_header_filter(r);

作用：进入 HTTP 头部过滤链，最终发送 HTTP 头。
逻辑：
- ngx_http_top_header_filter 是 Nginx 过滤链的入口，它会依次调用所有注册的头部过滤器（如 ngx_http_header_filter、ngx_http_chunked_filter 等）。
- 过滤链可能修改 HTTP 头（如添加 Server、Date 等字段），最终调用 ngx_http_write_filter 发送数据。
意义：
- Nginx 采用模块化设计，允许不同模块修改 HTTP 头（如 gzip 模块添加 Content-Encoding）。
- 过滤链机制让 Nginx 具有极高的扩展性。