Nginx 不支持在 http 块中直接使用 body_filter_by_lua* 指令，因其依赖 per-request 的输出过滤链机制，而 http 块无请求上下文；必须置于 server 或 location 块内，推荐在 server 块统一配置并按需在 location 中覆盖。
Nginx 本身不支持在 http 块中直接使用 body_filter_by_lua* 指令——该指令只能出现在 location 或 server 块内，**不能**在顶层 http 块中声明。
为什么不能在 http 块用 body_filter_by_lua*
body_filter_by_lua* 是基于 Nginx 的输出过滤链（output filter chain）机制工作的，而该机制是按请求（per-request）逐级挂载的，依赖于具体的 location 匹配上下文。http 块是全局配置作用域，不对应具体请求处理阶段，因此 Lua 过滤器无法在此注册。
如果你尝试在 http 块中写：
body_filter_by_lua_block { ... } ← 配置会直接报错：“unknown directive 'body_filter_by_lua_block'”
如何实现“全局”响应体过滤效果
所谓“全局”，实际是指对大部分或全部 location 生效。可行方案有以下几种：
-
统一 base location 配置：把公共的
body_filter_by_lua*放在server块顶层，它会对该 server 下所有未显式覆盖的 location 生效 -
使用 map + 变量控制开关：配合
set_by_lua*和map定义是否启用过滤逻辑，再在每个 location 中条件调用 -
抽象为 Lua 模块复用：把过滤逻辑封装进
lua_package_path中的模块，在各 location 中统一 require + 调用，保持行为一致 - 借助 lua-resty-header-filter 或第三方模块：某些社区模块提供更灵活的注入方式，但本质仍是 location 级挂载
推荐做法：server 块统一挂载 + location 局部覆盖
这是最清晰、可维护性最强的方式。示例：
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;"># 全局启用 body 过滤（对本 server 所有 location 有效）
body_filter_by_lua_block {
-- 读取当前 chunk
local chunk = ngx.arg[1]
if chunk ~= "" then
-- 示例：添加 HTML 注释到响应体末尾（仅限 text/html）
if ngx.header.content_type and string.find(ngx.header.content_type, "text/html") then
ngx.arg[1] = chunk .. "<!-- filtered by lua -->"
end
end
-- ngx.arg[2] 是 is_last，表示是否为最后一块，可用于收尾操作
}
location /api/ {
proxy_pass http://backend;
# 此处可禁用或替换过滤逻辑
# body_filter_by_lua_block { } ← 显式清空，或写新逻辑
}
location / {
root /var/www/html;
}}
注意事项与限制
- body 过滤器是流式处理的，响应体被分块（chunk）传递，
ngx.arg[1]是当前 chunk，ngx.arg[2]表示是否为末块 - 不能在过滤器中调用阻塞操作（如同步 socket、sleep），否则会卡住整个 worker
- 修改
ngx.arg[1]只影响当前 chunk；若需重写整个响应体，应结合lua_capture_filter或改用content_by_lua*+subrequest方式 - 确保
lua_shared_dict等资源已在 http 块中预定义，但过滤器本身仍须在 location/server 中注册
