Nginx自定义模块：如何在过滤器中实现客户端重定向？

嘿，我来帮你搞定这个Nginx自定义模块里的重定向问题！你之前遇到的空200响应问题，核心原因是Body过滤器的执行时机太晚了——如果响应头已经发送给客户端，这时候再修改状态码和Location头就完全无效了，客户端只会收到之前已经发出的200头，再加上你返回的空body，就出现了那种奇怪的现象。

下面给你两种解决方案，优先推荐第一种，因为更符合Nginx过滤器的设计逻辑：

方案一：移到Header过滤器中处理重定向（推荐） #

Header过滤器是在响应头发送前执行的，这时候修改状态码和响应头是完全有效的，也是Nginx处理这类逻辑的标准做法。你可以把判断逻辑移到Header过滤器里，代码示例如下：

static ngx_int_t ngx_http_mymodule_header_filter(ngx_http_request_t *r) {
    ngx_http_mymodule_ctx_t *ctx = ngx_http_get_module_ctx(r, ngx_http_mymodule_module);
    if (ctx == NULL) {
        return ngx_http_next_header_filter(r);
    }

    bool success = __my_custom_logic(r);
    if (!success) {
        // 清除模块上下文
        ngx_http_set_ctx(r, NULL, ngx_http_mymodule_module);
        
        // 设置302重定向状态码
        r->headers_out.status = NGX_HTTP_MOVED_TEMPORARILY;
        // 初始化Location头节点
        r->headers_out.location = ngx_list_push(&r->headers_out.headers);
        if (r->headers_out.location == NULL) {
            return NGX_ERROR;
        }
        // 设置Location头的键值对
        ngx_str_set(&r->headers_out.location->key, "Location");
        ngx_str_set(&r->headers_out.location->value, (u_char *)"localhost");
        r->headers_out.location->hash = 1;
        
        // 清除不必要的响应头（比如Content-Length、Last-Modified等）
        r->headers_out.content_length_n = 0;
        ngx_http_clear_content_length(r);
        ngx_http_clear_accept_ranges(r);
        ngx_http_clear_last_modified(r);
        ngx_http_clear_etag(r);
        
        // 发送重定向响应头
        return ngx_http_send_header(r);
    }

    // 逻辑满足，继续执行下一个Header过滤器
    return ngx_http_next_header_filter(r);
}

这样修改后，当你的自定义逻辑不满足时，会在响应头发送前就设置好302状态和Location头，客户端能正确收到重定向响应。

方案二：必须在Body过滤器中处理的情况 #

如果你的重定向逻辑必须依赖Body内容（比如需要解析Body后判断是否重定向），那一定要先检查响应头是否已经发送，再执行重定向操作，代码示例如下：

static ngx_int_t ngx_http_mymodule_body_filter(ngx_http_request_t *r, ngx_chain_t *in) {
    ngx_http_mymodule_ctx_t *ctx = ngx_http_get_module_ctx(r, ngx_http_mymodule_module);
    if (ctx == NULL) {
        return ngx_http_next_body_filter(r, in);
    }

    bool success = __my_custom_logic(r);
    if (!success) {
        ngx_http_set_ctx(r, NULL, ngx_http_mymodule_module);
        
        // 关键检查：如果响应头已经发送，就无法再修改状态码了
        if (r->header_sent) {
            ngx_log_error(NGX_LOG_ERR, r->connection->log, 0, "无法执行重定向：响应头已发送");
            return NGX_ERROR;
        }
        
        // 设置302重定向状态和Location头
        r->headers_out.status = NGX_HTTP_MOVED_TEMPORARILY;
        r->headers_out.location = ngx_list_push(&r->headers_out.headers);
        if (r->headers_out.location == NULL) {
            return NGX_ERROR;
        }
        ngx_str_set(&r->headers_out.location->key, "Location");
        ngx_str_set(&r->headers_out.location->value, (u_char *)"localhost");
        r->headers_out.location->hash = 1;
        
        // 清除不必要的响应头
        r->headers_out.content_length_n = 0;
        ngx_http_clear_content_length(r);
        ngx_http_clear_accept_ranges(r);
        ngx_http_clear_last_modified(r);
        ngx_http_clear_etag(r);
        
        // 发送重定向头和空body
        if (ngx_http_send_header(r) != NGX_OK) {
            return NGX_ERROR;
        }
        return ngx_http_send_special(r, NGX_HTTP_LAST);
    }

    ngx_http_set_ctx(r, NULL, ngx_http_mymodule_module);
    // 逻辑满足，继续执行下一个Body过滤器
    return ngx_http_next_body_filter(r, in);
}

关键注意点： #

• 一定要检查r->header_sent：如果这个值为1，说明响应头已经发送给客户端，HTTP协议不允许在之后修改状态码，这种情况下只能记录日志或者返回错误。
• 必须正确初始化Location头的结构体：不能只设置r->headers_out.location的value，还要确保节点被正确push到headers列表中，并且设置hash值。
• 清除无关响应头：重定向的响应body是空的，所以要清除Content-Length等可能导致客户端误解的头。

你之前的尝试失败，就是因为没有考虑响应头是否已发送，也没有正确初始化Location头的结构，导致头没有被正确发送出去，客户端自然只收到了空的200响应。

内容的提问来源于stack exchange，提问作者Ivan Stanev