Web 服务器与网关 / 系统课时
处理错误页面与访问权限
处理错误页面与访问权限
本课解决静态站点部署后常见的 403 无权限访问和 404 文件不存在问题,通过配置错误页面、检查 Nginx 用户权限和目录访问条件,建立完整的故障定位流程。
学习目标
- 配置 Nginx 自定义错误页面。
- 排查文件、目录和运行用户权限问题。
- 根据日志快速定位静态站点访问失败原因。
认识静态站点错误来源
静态文件访问失败通常来自三类原因:请求路径不存在、Nginx 无法读取文件、目录访问策略阻止访问。
404 表示请求资源不存在,重点检查 URL 与文件路径映射;403 表示资源存在但访问被拒绝,重点检查权限、目录索引和安全策略。
配置自定义错误页面
Nginx 可以通过 error_page 将错误请求转发到指定页面,让用户看到友好的提示,同时保持服务器返回正确状态码。
nginx
server {
listen <PORT>;
server_name example.com;
root /var/www/site;
error_page 404 /404.html;
error_page 403 /403.html;
location = /404.html {
internal;
}
location = /403.html {
internal;
}
}预期结果
text
访问不存在文件时返回 HTTP 404,并展示 /404.html 内容。
访问无权限资源时返回 HTTP 403,并展示 /403.html 内容。排查 403 权限问题
Nginx worker 进程通常不是 root 用户运行。如果站点目录或文件权限不允许该用户读取,即使文件存在也会返回 403。可以先检查目录链路权限:
bash
namei -l /var/www/site/index.html
ls -l /var/www/site/index.html预期输出
text
f: /var/www/site/index.html
drwxr-xr-x root root /var
-rw-r--r-- nginx nginx index.html检查结果应确保 Nginx 运行用户具备目录执行权限和文件读取权限。
检查目录遍历与安全策略
如果请求目录而目录中没有默认首页,同时又关闭了目录列表,Nginx 可能返回 403。生产环境通常关闭目录浏览,避免暴露文件结构。
nginx
location /files/ {
autoindex off;
}预期结果
text
访问 /files/ 且无 index 文件时返回 HTTP 403。如果权限看起来正确,还需要检查 SELinux、安全模块、防火墙策略或挂载参数是否阻止访问。
建立故障定位顺序
排查静态站点错误时,应先看 Nginx 错误日志,再确认配置映射,然后检查文件权限。不要直接修改权限扩大范围,应先确认真正失败的环节。
bash
tail -f /var/log/nginx/error.log预期输出
text
open() "/var/www/site/missing.html" failed (2: No such file or directory)日志中的 No such file or directory 通常对应路径错误,而 Permission denied 通常对应权限问题。
按自己的节奏,确认真正理解。