在 nginx 中,`server_name` 配合 `error_page` 实现自定义 404 页面的核心做法是:在对应的 server 块内定义 server_name 以匹配特定域名,并在该块内部使用 error_page 404 /custom_404.html; 指令指定错误处理路径。nginx 会优先根据请求的 host 头匹配 server_name,进入相应的配置块后,若找不到对应文件则触发 404 错误,此时 nginx 内部重定向到指定的自定义页面并返回 200 状态码(除非另行配置)。这种方法确保了不同域名的用户访问不存在的资源时,看到的是各自定制的友好提示。

如何为单个域名配置独立的 404 页面
针对单一域名,只需在 server 块中同时声明 server_name 和 error_page 即可。当请求到达时,Nginx 检查域名是否匹配,若匹配则加载该块内的配置;如果请求的文件不存在,Nginx 将执行 error_page 定义的逻辑,通常是将内部 URI 重写为自定义 HTML 文件的路径。这种方式简单直接,适用于大多数单站点部署场景。

server {
listen 80;
server_name www.example.com;
root /var/www/html;
index index.html;
# 定义 404 错误页
error_page 404 /404.html;
location = /404.html {
root /var/www/errors;
internal;
}
}
上述配置中,/var/www/html 是网站根目录,/var/www/errors 存放自定义错误页。internal 指令确保只有内部重定向才能访问 /404.html,防止用户直接通过 URL 访问该文件。当访问 www.example.com/nonexistent 时,Nginx 返回 404 状态码并展示自定义内容。
多域名环境下如何隔离不同站点的 404 页面
在多域名共享同一 IP 或端口的场景中,每个域名应拥有独立的 server 块,并在各自的块中定义不同的 error_page 路径。这样,即使多个域名指向同一个服务器,Nginx 也能根据 server_name 区分请求归属,并为每个域名提供专属的错误页面。这种隔离机制避免了跨域错误信息的混淆,提升了用户体验的一致性。

# 域名 A 的配置
server {
listen 80;
server_name a.example.com;
root /var/www/a;
error_page 404 /a_404.html;
location = /a_404.html {
root /var/www/errors;
internal;
}
}
# 域名 B 的配置
server {
listen 80;
server_name b.example.com;
root /var/www/b;
error_page 404 /b_404.html;
location = /b_404.html {
root /var/www/errors;
internal;
}
}
此配置展示了两个独立域名如何分别绑定不同的 404 页面。当访问 a.example.com/missing 时,Nginx 返回 /a_404.html;而访问 b.example.com/missing 时,则返回 /b_404.html。关键在于每个 server 块必须完整包含其自身的 error_page 和对应的 location 定义,否则将继承默认行为或父级配置。
error_page 返回的状态码是 404 还是 200
默认情况下,error_page 404 /path; 会导致 Nginx 内部重定向到指定路径,并最终返回 200 OK 状态码,因为重定向后的资源被视为正常请求。若希望保留原始 404 状态码,需在 location 块中使用 return 404; 或结合 add_header 手动设置。这一行为差异影响前端路由判断和 SEO 抓取,需根据业务需求选择是否修改默认响应码。











