在 nginx 中配置 404 缓存时间,核心方法是使用 error_page 指令捕获 404 状态码,并通过 add_header cache-control 为生成的响应添加缓存控制头。具体做法是定义一个内部重定向或返回特定内容的错误页面,并在该上下文中设置 cache-control: max-age=3600(或其他秒数),这样浏览器和中间代理就会按照设定的有效期存储这个 404 响应。

如何为静态资源配置常规缓存策略
对于正常的静态资源,Nginx 通过 location 块匹配文件路径,并使用 expires 指令直接设置过期时间。例如,将图片缓存一天,只需在匹配 .jpg 或 .png 的 location 中添加 expires 1d。这会自动生成 Cache-Control 和 Expires 响应头,无需手动编写复杂的逻辑。

server {
listen 80;
server_name example.com;
# 常规静态资源缓存
location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
root /var/www/html;
expires 1d;
add_header Cache-Control "public, immutable";
}
# 404 错误页处理
error_page 404 /custom_404.html;
location = /custom_404.html {
root /var/www/html;
internal;
add_header Cache-Control "max-age=3600";
}
}
如何处理动态接口返回的 404 状态
当 API 接口返回 404 时,上述基于文件的 error_page 可能不生效,因为请求并未映射到物理文件。此时需要在 location 中使用 if 或 return 判断,或者确保后端应用返回 404 时,Nginx 能正确传递缓存头。更通用的做法是在全局或特定 location 中,针对非 2xx/3xx 状态码统一添加缓存头,但需注意避免缓存成功的响应。

server {
listen 80;
server_name api.example.com;
location /api/ {
proxy_pass http://backend;
# 仅对 404 响应添加缓存头
# 注意:Nginx 默认不会修改后端返回的头部,需使用 add_header
# 但 add_header 在有 if 或某些条件下可能失效,建议用 map 或子请求
# 这里展示一种简单场景:如果后端返回 404,我们希望缓存它
# 更稳健的方式是使用 ngx_http_headers_module 的条件添加
# 但由于 Nginx 原生不支持按状态码条件添加 header,
# 通常建议在应用层设置,或使用 Lua (OpenResty)
# 假设我们使用一个简单的 fallback 机制
error_page 404 = @handle_404;
}
location @handle_404 {
# 内部重定向到一个返回固定 404 的 handler
return 404 '{"error": "not found"}';
add_header Content-Type application/json;
add_header Cache-Control "max-age=300";
}
}
为什么有时设置的 404 缓存不生效?
常见原因是 add_header 指令的作用域问题。如果在 location 中已经使用了 proxy_pass,且后端返回了 Cache-Control 头,Nginx 默认会用后端的头覆盖本地的 add_header。此外,error_page 指向的文件必须存在且可访问,否则会导致循环错误或 500。另一个关键是 internal 指令的使用,防止外部直接访问内部错误页面。











