在 nginx 中使用 alias 配合 add_header 设置缓存头时，核心在于理解 alias 会改变请求 uri 到文件系统的映射路径，而 add_header 默认继承自当前配置块。若直接在 location 中设置 add_header，它仅对静态文件和由 try_files 成功匹配的文件生效；对于通过 alias 指向的非标准路径或内部重定向，需确保 add_header 位于正确的上下文且未被覆盖。通常做法是在指定 alias 的 location 块内直接添加 add_header cache-control 等指令，nginx 会将这些头部附加到响应中。
alias 与 add_header 的基础配置结构是怎样的
基础配置是将 add_header 指令放在使用 alias 的 location 块内部。这样，当请求匹配该位置时，Nginx 会应用该块内的所有指令，包括设置缓存控制头部。例如，将 /images/ 映射到磁盘上的 /var/www/images/ 目录，并在该目录下所有文件的响应中添加 Cache-Control: public, max-age=31536000。这种结构确保了头部信息仅应用于特定路径的资源，避免全局污染。
server {
listen 80;
server_name example.com;
location /images/ {
alias /var/www/static/images/;
add_header Cache-Control "public, max-age=31536000";
add_header X-Content-Type-Options "nosniff";
}
}
上述配置中，alias 定义了物理路径，add_header 设置了 HTTP 响应头。客户端请求 http://example.com/images/logo.png 时，Nginx 会在 /var/www/static/images/logo.png 查找文件，并在响应中包含指定的缓存头。注意 alias 末尾的斜杠必须与 location 中的路径对应，否则可能导致 404 错误。此外，add_header 的值需用双引号包裹，以支持空格和特殊字符。
为什么有时 add_header 设置的缓存头不生效
add_header 不生效通常是因为它被更高级别的配置覆盖，或者仅在特定条件下才添加头部。Nginx 的规则是：如果父级 location 或 server 块中使用了 add_header，子级 location 中的 add_header 不会自动继承，除非显式声明。因此，若在 server 块中已定义 add_header，而在 location 中再次定义，后者会完全替换前者，导致部分头部丢失。另一个常见原因是 error_page 或内部重定向改变了响应状态码，而 add_header 默认只对 2xx 和 3xx 状态码生效，可通过 always 参数强制添加。
server {
listen 80;
server_name example.com;
# 全局头部，可能被覆盖
add_header X-Global-Header "value";
location /images/ {
alias /var/www/static/images/;
# 必须重新声明全局头部，否则只保留下面的头部
add_header X-Global-Header "value";
add_header Cache-Control "public, max-age=31536000" always;
}
}
在上面的代码中，server 块定义的 X-Global-Header 在 location 块中不会自动继承。因此，必须在 location 中再次声明 add_header X-Global-Header，以确保该头部出现在响应中。同时，使用 always 参数确保即使发生错误（如 404），缓存头也会被添加。这解决了因状态码变化导致的头部缺失问题。验证时，可使用 curl -I http://example.com/images/test.png 检查响应头是否包含预期内容。
如何针对特定文件类型动态设置不同的缓存策略
针对特定文件类型设置不同缓存策略，可以通过 map 指令结合 if 或 location 正则表达式实现。例如，为图片文件设置长期缓存，而为 HTML 文件设置无缓存。使用 ~* \.jpg$ 这样的正则匹配图片扩展名，并在对应的 location 块中设置 add_header Cache-Control。这种方法允许细粒度控制，但需注意 if 指令在 location 中的局限性，优先使用多个 location 块来分离不同文件类型的处理逻辑。
server {
listen 80;
server_name example.com;
location ~* \.(jpg|jpeg|png|gif)$ {
alias /var/www/static/images/;
add_header Cache-Control "public, max-age=31536000";
}
location ~* \.html$ {
alias /var/www/static/html/;
add_header Cache-Control "no-cache, no-store, must-revalidate";
}
}
此配置中，第一个 location 块匹配所有图片文件，并设置长期缓存；第二个块匹配 HTML 文件，设置立即失效的缓存策略。每个 location 块独立处理其匹配的资源，互不干扰。实际应用中，可根据业务需求调整缓存时长和策略。例如，对于频繁更新的 JS/CSS 文件，可采用版本号或哈希值作为文件名的一部分，以便设置长期缓存而不必担心过期问题。通过这种方式，可以优化资源加载性能，同时确保关键内容的实时性。
