nginx关于add_header的坑及解决

在Nginx的配置中，add_header指令是一个强大的工具，用于在HTTP响应头中添加自定义字段。然而，正如许多看似简单的工具一样，add_header也有其潜在的“坑”。

一、重复与覆盖问题

add_header只是添加，而不是重写。这意味着如果之前已经有相同的头存在，再次使用add_header添加同样的头可能会导致内容被覆盖或重复。为了避免这种情况，我们需要确保在添加头之前，该头没有被其他配置设置。

二、处理阶段与重写问题

add_header的处理阶段比location处理晚，这意味着如果在location块中使用了rewrite指令，可能会丢失之前未处理的add_header。例如，在/a的location中添加了头a，然后重写到了/b，那么在/b的location中可能无法看到a头。

三、错误页面的头设置问题

在低版本的Nginx中，add_header不支持在错误页面中使用。即使在高版本中，如果不加always参数，add_header也可能在错误页面中不生效。因此，在需要为错误页面设置自定义头时，请确保使用always参数。

四、解决方案

1. 明确头的来源：在添加头之前，检查是否有其他配置已经设置了该头。
2. 注意处理阶段：如果使用了rewrite，确保在最终的目标location中再次添加必要的头。
3. 使用always参数：为错误页面设置头时，务必添加always参数。

通过注意以上几点，我们可以更好地利用add_header指令，避免潜在的问题。