nginx关于add_header的坑及解决

在nginx的配置中，add_header指令是一个常用的功能，用于为HTTP响应添加头信息。然而，这个看似简单的指令在实际应用中却隐藏着不少坑，稍有不慎就可能导致配置失效或者引发其他问题。

一、重复添加头的坑

add_header指令只能“添加”头信息，而不能重写已经存在的头。如果在nginx配置中多次使用add_header添加同一个头，会导致头信息被重复添加，这不仅不符合HTTP协议规范，还可能引发客户端处理错误。重点内容：因此，在使用add_header时，要特别注意避免重复添加同一个头信息。

二、对错误页面无效的坑

在nginx的低版本中，add_header指令在错误页面（如404页面）中是无效的。这意味着，即使你在配置中添加了自定义的头信息，这些头信息也不会在错误页面中生效。重点内容：解决这个问题的方法是，升级nginx到1.7.5及以上版本，并使用always参数，如add_header X-Custom-Header "CustomHeaderValue" always;。

三、配置位置不当的坑

add_header指令可以放置在http、server或location块内。然而，如果配置位置不当，可能会导致头信息无法正确添加。重点内容：确保add_header指令放置在正确的配置块内，并根据需要选择在全局、特定服务器或特定位置添加头信息。

四、解决步骤

1. 检查配置文件语法：使用nginx -t命令检查配置文件是否有语法错误。
2. 重新加载或重启nginx：每次修改配置文件后，使用sudo nginx -s reload或sudo systemctl restart nginx命令使更改生效。
3. 检查是否有其他配置覆盖：确保没有其他配置块中的add_header指令与你的指令冲突。
4. 使用浏览器开发者工具检查：刷新页面并查看请求的响应头，确认是否包含你添加的头信息。

总之，在使用nginx的add_header指令时，要特别注意避免上述坑点，确保配置正确有效。只有这样，才能充分发挥add_header指令的作用，为HTTP响应添加必要的头信息。