resty.request_merge

resty.request_merge 是 OpenResty 中的一个性能优化函数，用于合并 ngx.req API 调用，减少 Nginx 阶段切换开销。

基本介绍

• 所属模块：resty.core
• 功能：将多个 ngx.req API 调用合并到一次 C 函数调用中执行
• 主要优势：减少 Lua 与 Nginx 核心之间的上下文切换，提高高并发场景下的性能

为什么需要它？

每次调用 ngx.req API（如 get_method, get_uri_args 等）都会：

1. 从 Lua 代码切换到 Nginx C 代码
2. 执行相关操作
3. 返回结果到 Lua 代码

这种切换在高并发下会产生显著性能开销。request_merge 允许将多个操作打包到一次切换中完成。

使用方法

local request_merge = require "resty.core".request_merge

local res, err = request_merge({
    "get_method",
    "get_uri_args",
    {"get_headers", 0},  -- 参数传给 get_headers
    {"get_post_args", 0, 1024},  -- 带参数的调用
})

if not res then
    ngx.log(ngx.ERR, "merge failed: ", err)
    return
end

local method = res[1]
local uri_args = res[2]
local headers = res[3]
local post_args = res[4]

性能对比

普通方式（4次独立调用）：

local method = ngx.req.get_method()
local uri_args = ngx.req.get_uri_args()
local headers = ngx.req.get_headers()
local post_args = ngx.req.get_post_args()

合并方式（1次调用）：

local res = request_merge({
    "get_method",
    "get_uri_args",
    {"get_headers", 0},
    {"get_post_args", 0, 1024}
})

在高并发场景下，合并方式可减少 3-4 次阶段切换，性能提升明显。

支持的函数列表

• get_method
• get_uri_args
• get_headers
• get_post_args
• get_body_data
• get_body_file
• get_post_args_count
• get_uri_args_count

内部实现机制

resty.request_merge 通过 lua-resty-core 库实现，利用 FFI 直接调用 Nginx C API，避免了多次 Lua/C 上下文切换。

最佳实践

• 在需要获取多个请求信息时，优先使用 request_merge
• 对于只获取单个信息的场景，直接调用对应 API 即可
• 合理使用 request_merge 可以显著提升高并发 API 网关的性能

想了解更多 OpenResty 性能优化技巧吗？我可以介绍一些其他核心优化方法。