NGINX自定义500错误页无法加载、默认错误页生效问题咨询

排查修复步骤 #

• 开启错误拦截配置
  如果你的站点是反向代理上游服务，或者使用FastCGI（如PHP）处理请求，默认配置下NGINX不会拦截上游返回的错误码，会直接返回默认错误页，需要在对应server块中开启拦截开关，和你现有的error_page配置同级存放即可：

  # 反向代理场景添加
  proxy_intercept_errors on;
  # FastCGI（如PHP）场景添加
  fastcgi_intercept_errors on;
  

• 检查500.html文件权限
  确认/usr/share/nginx/html/500.html对NGINX运行用户（常见为nginx、www-data）开放读取权限，可执行以下命令修正：

  # 按实际运行用户调整所属用户组
  chown nginx:nginx /usr/share/nginx/html/500.html
  chmod 644 /usr/share/nginx/html/500.html
  

• 校验配置优先级
  确认你的error_page和对应location规则是写在server块下，而非嵌套在某个子location块中，避免仅部分路径触发规则。同时检查有没有其他更靠前的location规则匹配到/500.html覆盖了你的配置。
• 重载NGINX配置
  每次修改配置后先校验语法正确性，再重载生效：

  nginx -t
  # 语法测试通过后执行重载
  systemctl reload nginx
  

内容的提问来源于stack exchange，提问作者Captain Buck