NGINX环境下无法获取含点号请求头，如何添加带点号Header？

这个问题我之前帮不少用ABP框架的开发者排查过，核心原因是NGINX默认的请求头处理规则会修改带点号的自定义头，再加上后端框架的默认解析逻辑，就导致了本地调试正常但服务器部署后取不到值的情况。下面给你分步解决：

1. 调整NGINX的请求头传递配置 #

NGINX默认会把请求头里的点号转换成下划线，并且默认不允许头名里包含下划线（underscores_in_headers默认是off），这就导致带点的Abp.TenantId到了NGINX这里会被转成abp_tenantid，如果不手动配置，后端可能接收不到原始的头名，或者被过滤掉。

你可以在对应的location块里添加以下配置，强制把转换后的变量还原成原始请求头传递给后端：

location /api/ {
    # 手动映射带点的请求头
    proxy_set_header Abp.TenantId $http_abp_tenantid;
    # 确保所有请求头都被传递
    proxy_pass_request_headers on;
    proxy_pass http://your-backend-service;
}

如果需要支持多个带点的头，或者想更通用地允许下划线头，可以在server或http块里开启下划线支持：

server {
    underscores_in_headers on;
    # 其他配置...
}

这个配置会让NGINX允许头名包含下划线，同时保留原始的头信息（不过带点的头还是会被转成下划线，所以还是建议手动映射需要的头）。

2. 后端框架（以ASP.NET Core/ABP为例）的适配配置 #

ASP.NET Core默认会忽略包含下划线的请求头（因为HTTP规范里不推荐头名用下划线，但允许），所以即使NGINX传递了abp_tenantid，后端可能也不会解析它。你可以做以下调整：

方式一：手动兼容两种头格式 #

在获取租户ID的时候，同时检查原始头名和转换后的头名：

var tenantId = Request.Headers["Abp.TenantId"].FirstOrDefault() 
               ?? Request.Headers["AbpTenantId"].FirstOrDefault();

方式二：配置框架允许解析下划线头 #

在Program.cs里添加配置，让框架允许解析包含下划线的自定义头：

builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    // 添加允许的自定义头
    options.KnownHeaders.Add("AbpTenantId");
});

// 或者配置Kestrel允许接收非标准头
builder.WebHost.ConfigureKestrel(options =>
{
    options.AllowSynchronousIO = true; // 按需开启，部分场景需要
    options.AddServerHeader = false;
});

3. 排查验证步骤 #

• 检查NGINX日志：添加自定义日志格式，确认NGINX是否接收到了请求头。比如在http块里添加：

  log_format custom_log '$remote_addr - $remote_user [$time_local] "$request" '
                       '$status $body_bytes_sent "$http_referer" '
                       '"$http_user_agent" "$http_abp_tenantid"';
  access_log /var/log/nginx/access.log custom_log;
  

  然后查看日志，确认$http_abp_tenantid是否有值，如果有说明NGINX已经接收到了头。
• 重启NGINX：修改配置后一定要执行sudo nginx -s reload让配置生效。
• 检查负载均衡/网关：如果服务器前面还有其他负载均衡（比如云厂商的SLB），要确认这些组件是否也会修改请求头，确保它们保留了Abp.TenantId头。

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