在 OpenResty 中，如果你发现通过 ngx.req.set_header 或 proxy_set_header 无法成功添加自定义头部，可能是以下原因导致的。以下是完整解决方案和调试方法：
1. 确认阶段（Phase）是否正确
OpenResty 的 Lua 执行阶段必须选对：
- 修改请求头：必须在
access_by_lua_*或rewrite_by_lua_*阶段（转发到上游之前）。 - 修改响应头：需在
header_filter_by_lua_*阶段。
location /proxy {
proxy_pass http://upstream_server;
# ✅ 正确阶段：在转发前添加请求头
access_by_lua_block {
ngx.req.set_header("X-My-Header", "value123")
}
}
2. 检查头部是否被覆盖
Nginx 的 proxy_set_header 会覆盖 Lua 设置的头部。确保没有冲突：
location /proxy {
proxy_pass http://upstream_server;
# ❌ 错误：proxy_set_header 会覆盖 Lua 设置的 Host
proxy_set_header Host "fixed.com";
access_by_lua_block {
ngx.req.set_header("Host", "dynamic.com") -- 这行无效！
}
# ✅ 正确：只用 Lua 动态设置
access_by_lua_block {
ngx.req.set_header("Host", "dynamic.com")
}
}
3. 隐藏的默认配置
某些 Nginx 配置模板（如云厂商的默认配置）可能会清除自定义头部。检查是否存在：
proxy_pass_request_headers off; # ❌ 这会禁止所有请求头转发！
4. Lua代码调试
打印当前所有请求头，确认是否生效：
access_by_lua_block {
ngx.req.set_header("X-Debug", "test")
-- 打印所有请求头到 error.log
local h = ngx.req.get_headers()
for k, v in pairs(h) do
ngx.log(ngx.ERR, "HEADER: ", k, "=", v)
end
}
查看日志定位问题：
tail -f /usr/local/openresty/nginx/logs/error.log
5. HTTP/2兼容性问题
如果使用 HTTP/2，某些头部（如:authority）需要特殊处理：
access_by_lua_block {
ngx.req.set_header(":authority", "new.domain.com") -- HTTP/2专用语法
}
6.终极解决方案：强制覆盖所有代理指令
如果其他方法无效，直接重置代理相关指令：
location /proxy {
proxy_pass http://upstream_server;
# 👇 清除可能干扰的默认配置
proxy_set_header Host "";
proxy_set_header X-Forwarded-For "";
access_by_lua_block {
ngx.req.clear_header("Host") --先清除旧值
ngx.req.set_header("Host", "custom.domain.com")
ngx.req.set_header("X-Real-IP", ngx.var.remote_addr)
}
}
验证工具
- curl测试：
curl -H "Original-Header: foo" http://your_openresty_server/proxy -v - 上游服务日志：检查上游服务收到的实际头部。
按照上述步骤排查后，99%的问题都能解决。如果仍不生效，可能是网络设备（如负载均衡器）过滤了头部，需检查整个链路。
内容由零声教学AI助手提供，问题来源于学员提问
