OpenResty中ngx.req系列API获取请求体返回nil问题排查求助

你的问题是配置错误导致的，核心原因出在proxy_request_buffering off这个配置上：

• 当proxy_request_buffering设为off时，Nginx会直接把客户端的请求体流式转发给后端服务器，不会在本地缓冲请求体内容。这就导致ngx.req.read_body()无法读取到请求体，自然ngx.req.get_body_data()、ngx.req.get_body_file()、ngx.var.request_body都会返回nil。

另外，你注释掉的lua_need_request_body on也会影响请求体读取：

• 这个配置强制Nginx在执行Lua代码前读取完整请求体，但它和proxy_request_buffering off无法兼容——后者的流式转发逻辑会绕过请求体缓冲流程。

解决步骤 #

1. 启用请求体缓冲：
   将proxy_request_buffering off改为proxy_request_buffering on（这是Nginx默认值，也可以直接删除该行配置）。开启缓冲后，Nginx会先完整接收请求体，Lua代码才能读取到内容。

2. 启用lua_need_request_body：
   取消# lua_need_request_body on的注释，确保Nginx在执行access_by_lua_block前已经读取完请求体。虽然ngx.req.read_body()也能触发读取，但显式配置更可靠。

3. 调整请求体大小限制：
   当前client_max_body_size 0表示不限制请求体大小，建议根据业务实际设置合理值（比如你注释掉的50M），避免过大请求占用过多内存。

修改后的核心配置片段：

location / {
    client_body_buffer_size     50M;
    client_max_body_size        50M;
    proxy_request_buffering on; # 或直接删除，默认开启
    proxy_http_version 1.1;
    lua_need_request_body on;
    proxy_pass   http://localhost:8000;

    access_by_lua_block {
        local body = ngx.req.get_body_data()
        if body then
            ngx.log(ngx.STDERR, "THERE BODY")
            body = ngx.re.gsub(body, "string1", "string2")
            ngx.req.set_body_data(body)
        else
            ngx.log(ngx.STDERR, "NO BODY")
        end
    }
}

补充说明 #

如果你的业务场景确实需要流式转发请求体（无法开启缓冲），那Lua代码无法在access_by_lua_block阶段修改请求体，这种情况下需要借助ngx.stream模块或其他方案处理，不过这属于特殊场景，大部分业务场景开启缓冲即可解决问题。

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