ngx_http_internal_redirect

1 定义ngx_http_internal_redirect 函数 定义在 ./nginx-1.24.0/src/http/ngx_http_core_module.cngx_int_tngx_http_internal_redirect(ngx_http_request_t*r,ngx_str_t*uri,ngx_str_t*args){ngx_http_core_srv_conf_t*cscf;r-uri_changes--;if(r-uri_changes0){ngx_log_error(NGX_LOG_ERR,r-connection-log,0,rewrite or internal redirection cycle while internally redirecting to \%V\,uri);r-main-count;ngx_http_finalize_request(r,NGX_HTTP_INTERNAL_SERVER_ERROR);returnNGX_DONE;}r-uri*uri;if(args){r-args*args;}else{ngx_str_null(r-args);}ngx_log_debug2(NGX_LOG_DEBUG_HTTP,r-connection-log,0,internal redirect: \%V?%V\,uri,r-args);ngx_http_set_exten(r);/* clear the modules contexts */ngx_memzero(r-ctx,sizeof(void*)*ngx_http_max_module);cscfngx_http_get_module_srv_conf(r,ngx_http_core_module);r-loc_confcscf-ctx-loc_conf;ngx_http_update_location_config(r);#if(NGX_HTTP_CACHE)r-cacheNULL;#endifr-internal1;r-valid_unparsed_uri0;r-add_uri_to_alias0;r-main-count;ngx_http_handler(r);returnNGX_DONE;}ngx_http_internal_redirect 函数是 Nginx 实现内部重定向的核心函数。 它用新的 URI 和参数替换请求当前的值 清除模块上下文并重置配置 然后重新调用 ngx_http_handler 使请求从 server rewrite 阶段重新走一遍完整的处理流程 同时通过计数器防止无限循环。2 详解1 函数签名ngx_int_tngx_http_internal_redirect(ngx_http_request_t*r,ngx_str_t*uri,ngx_str_t*args)返回值 表示函数执行结果的状态码参数1 ngx_http_request_t *r 指向 当前 HTTP 请求结构体参数2 ngx_str_t *uri 表示新 URI 字符串参数3 ngx_str_t *args 表示新查询参数字符串2 逻辑流程1 重定向计数器 2 请求状态重置 3 重新启动请求处理1 重定向计数器{ngx_http_core_srv_conf_t*cscf;r-uri_changes--;将请求的内部重写剩余次数减 1。if(r-uri_changes0){ngx_log_error(NGX_LOG_ERR,r-connection-log,0,rewrite or internal redirection cycle while internally redirecting to \%V\,uri);r-main-count;ngx_http_finalize_request(r,NGX_HTTP_INTERNAL_SERVER_ERROR);returnNGX_DONE;}检查计数器是否归零。 归零表示重写次数超过限制 进行错误处理增加主请求的引用计数。 即将调用 ngx_http_finalize_request 结束请求该函数会递减引用计数。 先递增可避免计数降为 0 导致请求被过早释放。 意义保证请求对象在终结期间有效。以 500 状态码终结请求发送错误响应返回 NGX_DONE 告诉调用者请求已处理完毕 当前处理路径应停止。2 请求状态重置r-uri*uri;将请求的 URI 替换为新的目标 URI。if(args){r-args*args;}else{ngx_str_null(r-args);}ngx_log_debug2(NGX_LOG_DEBUG_HTTP,r-connection-log,0,internal redirect: \%V?%V\,uri,r-args);如果调用者提供了新参数则更新 r-args。 如果 args 为 NULL则清空请求的参数设为空字符串。ngx_http_set_exten(r);根据新 URI 提取文件扩展名如 .html存入 r-exten/* clear the modules contexts */ngx_memzero(r-ctx,sizeof(void*)*ngx_http_max_module);清空模块上下文 将 r-ctx 数组每个模块一个指针全部清零。 内部重定向相当于重新处理请求 每个模块在上次处理中可能存储的私有数据必须清空防止干扰新流程。 意义保证请求状态干净如新是正确执行第二次处理的前提。cscfngx_http_get_module_srv_conf(r,ngx_http_core_module);r-loc_confcscf-ctx-loc_conf;重置 location 配置 获取当前虚拟主机的核心模块配置 cscf 将请求的 location 配置指针重置为 server 级别的默认 location 配置 重定向后需要重新匹配 location 因此先脱离之前匹配到的具体 location 回到 server 默认配置作为起点。ngx_http_update_location_config(r);根据当前的 r-loc_conf现在是 server 默认配置更新请求的运行状态 虽然随后会再次匹配 location 并可能再次调用此函数 但此时先应用 server 基本配置保证处理基础环境正确。#if(NGX_HTTP_CACHE)r-cacheNULL;#endif清除缓存指针 如果启用了 HTTP 缓存模块 将请求的缓存对象指针置 NULL。 意义避免旧缓存上下文干扰新请求的处理。r-internal1;r-valid_unparsed_uri0;r-add_uri_to_alias0;r-main-count;标记当前请求为“内部请求” 清除“未解析 URI 有效”标志。 原未解析 URI 已失效后续如果需要会重新生成。 清除 add_uri_to_alias 标志 该标志用于 alias 处理时控制是否将 URI 附加到别名路径后。 意义避免 alias 逻辑错误拼接。 增加主请求的引用计数。 逻辑接下来调用 ngx_http_handler(r) 会重新进入异步处理流程 请求可能被挂起如等待子请求、I/O。 增加引用计数确保在此期间请求对象不被释放。 意义遵循 Nginx 的引用计数管理保证异步安全。3 重新启动请求处理ngx_http_handler(r);调用 HTTP 请求处理的总入口函数returnNGX_DONE;}返回 NGX_DONE 给调用者 逻辑NGX_DONE 表示“请求已转交当前处理应停止”。