解决 Nginx 自定义 400 错误页面 SSL 资源加载问题

碧海醫心

碧海醫心

2025-11-21

579人浏览

原创

解决 nginx 自定义 400 错误页面 ssl 资源加载问题

本文旨在解决在使用 Nginx 配置自定义 400 错误页面时,当用户通过 HTTP 访问 HTTPS 端口时,页面资源无法正确加载的问题。通过配置 Nginx 的 default_server,确保所有进入服务器的请求都能被正确处理,并提供一个统一的错误页面,从而提升用户体验。

当配置 Nginx 时,如果用户尝试通过 HTTP 访问配置了 SSL 的 HTTPS 端口,可能会遇到自定义错误页面显示不正确,资源(如图片、CSS 文件等)无法加载的问题。这是因为 Nginx 在选择处理请求的 server 块时,会根据端口、协议(HTTP 或 HTTPS)以及 server_name 进行匹配。如果找不到完全匹配的 server 块,可能会返回 400 错误。

问题分析

在提供的 Nginx 配置中,server 块只监听了 HTTPS 协议的 789 端口。当用户通过 HTTP 协议访问该端口时,Nginx 无法找到对应的 server 块来处理该请求,因此会返回一个 400 错误。虽然配置了自定义的 400 错误页面,但由于请求的协议是 HTTP,页面中的资源链接(如 src="../error_pages/assets/images/img12.png")也是基于 HTTP 的,而此时 Nginx 并没有配置处理 HTTP 请求的 server 块,导致资源无法加载。

解决方案:配置 default_server

为了解决这个问题,建议配置一个 default_server 来处理所有未匹配到其他 server 块的请求。default_server 可以用来处理所有进入服务器的请求,并提供一个统一的错误页面,或者进行其他自定义操作。

以下是一个配置 default_server 的示例:

度加AI
度加AI

度加AI官网入口,百度官方 AIGC 创作平台,支持 AI 成片、AI 生文、数字人、声音克隆、配音字幕与智能剪辑等在线创作能力。

下载
server {
    listen 789; # 监听 HTTP 协议的 789 端口
    server_name  _; # 匹配所有域名

    return 400 "Bad Request: Please use HTTPS"; # 返回 400 错误,并提示使用 HTTPS

    # 或者,也可以重定向到 HTTPS
    # return 301 https://$host$request_uri;

    # 或者,返回自定义错误页面
    # error_page 400 /400_page.html;
    # location = /400_page.html {
    #     root /etc/nginx/error_pages;
    #     internal;
    # }
}

配置详解:

  1. listen 789;: 监听 789 端口,但没有指定 ssl 参数,因此处理的是 HTTP 请求。
  2. server_name _;: _ 是一个通配符,表示匹配所有域名。这意味着,任何未匹配到其他 server 块的 HTTP 请求都会被这个 server 块处理。
  3. return 400 "Bad Request: Please use HTTPS";: 直接返回一个 400 错误,并提示用户使用 HTTPS 协议。也可以使用 return 301 https://$host$request_uri; 进行重定向,将 HTTP 请求自动跳转到 HTTPS。
  4. 自定义错误页面 (可选): 可以将 HTTP 请求导向自定义的 400 错误页面。这需要配置 error_page 指令和对应的 location 块,与原始配置中的 HTTPS server 块类似。

注意事项:

  • 确保 default_server 的配置在其他 server 块之前,以便优先匹配。
  • 根据实际需求,选择合适的处理方式:直接返回错误、重定向到 HTTPS 或返回自定义错误页面。
  • 如果选择返回自定义错误页面,需要确保页面中的资源链接使用绝对路径或相对于 root 指令的相对路径,以避免资源加载问题。例如,可以将CSS和JS文件放到统一的目录下,并在HTML中引用绝对路径,如/assets/css/style.css。同时,需要确保对应的 location 块配置正确。

修改后的 Nginx 配置示例(包含 default_server 和绝对路径资源引用):

upstream dashboardapp{

        server test_server:80;
}

server {
    listen 789;
    server_name  _;
    return 301 https://$host$request_uri;
}

server {
    listen 789 ssl;
    server_name  example.com;
    ssl_certificate /etc/nginx/certs/host.crt;
    ssl_certificate_key /etc/nginx/certs/host.key;

    location / {

        proxy_read_timeout 1800;
        proxy_connect_timeout 1800;
        proxy_send_timeout 1800;
        send_timeout 1800;
        proxy_hide_header x_destination;
        proxy_pass http://dashboardapp;

    }
    location /error_pages {
        root /etc/nginx/;
    }
    error_page 495 496 497 /400_page.html;
    location = /400_page.html {
        root /etc/nginx/error_pages;
        internal;
    }
    error_page 404 /404_page.html;
    location = /404_page.html {
        root /etc/nginx/error_pages;
        internal;
    }

    error_page 500 /500_page.html;
    location = /500_page.html {
        root /etc/nginx/error_pages;
        internal;
    }
    error_page 502 /502_page.html;
    location = /502_page.html {
        root /etc/nginx/error_pages;
        internal;
    }
    error_page 503 /503_page.html;
    location = /503_page.html {
        root /etc/nginx/error_pages;
        internal;
    }
    location /assets {
        root /etc/nginx/error_pages;
    }
}

修改后的错误页面示例(使用绝对路径):



    <meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Oops! Page not found</title><link rel="icon" href="/assets/images/cropped.png" type="image/x-icon"><link href="/assets/CSS/google.css" rel="stylesheet"><link href="/assets/CSS/googlefont2.css" rel="stylesheet"><style> /* 样式保持不变 */ </style><div id="notfound">
        <div class="notfound">
            @@##@@
            <p></p>
            <div class="notfound-404">
                <h3>Oops! Page not found</h3>
                <h1>
<span>4</span><span>0</span><span>0</span>
</h1>
            </div>
            <h3>The page you are looking for might have been removed had its name changed or is temporarily unavailable.</h3>
            <a id="myElementID" href="#" class="button" style="vertical-align:middle"><span>Home Page</span></a>
        </div>
    </div>

<script>
    var a = document.getElementById('myElementID');
    a.href = "http://"+window.location.hostname;
</script>

总结

通过配置 default_server,可以确保 Nginx 能够处理所有进入服务器的请求,即使协议不匹配也能提供友好的错误提示或重定向。同时,在自定义错误页面中,建议使用绝对路径或相对于 root 指令的相对路径来引用资源,以避免资源加载问题。 这将提升用户体验,并确保服务器的安全性。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

339

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1727

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

2125

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

416

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1244

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3808

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

102

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

272

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

107

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.3万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5万人学习

CSS教程
CSS教程

共754课时 | 84.5万人学习