本文旨在解决 Nginx 在 SSL 配置下，当用户通过 HTTP 访问 HTTPS 端口时，自定义 400 错误页面资源无法正确加载的问题。我们将分析问题原因，并提供配置 `default_server` 的解决方案，确保所有请求都能被正确处理，提升用户体验。
问题分析
当 Nginx 配置了 SSL (HTTPS) 监听端口，而用户尝试通过 HTTP 协议访问该端口时，Nginx 会返回 400 Bad Request 错误。如果配置了自定义的 400 错误页面，问题通常在于该页面中的资源（如 CSS、图片、JavaScript）无法正确加载。
根本原因是 Nginx 在处理 HTTP 请求时，无法找到匹配的 server 块。Nginx 根据端口、协议 (HTTP vs HTTPS) 和 server_name 来确定哪个 server 块应该处理请求。 当用户使用 HTTP 访问 HTTPS 端口时，请求的协议与配置的 HTTPS server 块不匹配，导致 Nginx 无法正确处理请求。
此外，错误页面中的资源路径通常是相对路径，例如 ../error_pages/assets/images/img12.png。当浏览器尝试加载这些资源时，它会基于当前的 URL 构建完整的资源 URL。由于原始请求是 HTTP，浏览器会尝试通过 HTTP 加载资源，但这些资源实际上只能通过 HTTPS 访问，从而导致加载失败。
解决方案：配置 default_server
解决此问题的最佳方法是配置一个 default_server 来处理所有未匹配的 HTTP 请求。 default_server 是 Nginx 中一个特殊的 server 块，用于处理所有无法与其他 server 块匹配的请求。
以下是配置 default_server 的步骤：
-
创建 HTTP server 块： 创建一个新的 server 块，监听 HTTP 端口（通常是 80）。将此 server 块配置为 default_server。
配置重定向或错误页面： 在此 server 块中，你可以选择将所有 HTTP 请求重定向到 HTTPS，或者返回一个自定义的错误页面。
确保资源路径正确： 无论选择重定向还是错误页面，都需要确保页面中的资源路径是正确的。建议使用绝对路径或协议相对路径，以避免资源加载问题。
示例配置：
server {
listen 80 default_server;
server_name _; # Catch-all server name
# 将所有 HTTP 请求重定向到 HTTPS
return 301 https://$host$request_uri;
# 或者，返回自定义的 400 错误页面
# error_page 400 /custom_400.html;
# location = /custom_400.html {
# root /path/to/error_pages;
# internal;
# }
}
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/certs/host.crt;
ssl_certificate_key /etc/nginx/certs/host.key;
# 其他配置...
}
代码解释：
- listen 80 default_server; 指定该 server 块监听 80 端口，并将其设置为 default_server。
- server_name _; 使用通配符 _ 作为 server_name，表示匹配所有域名。
- return 301 https://$host$request_uri; 使用 301 永久重定向将所有 HTTP 请求重定向到 HTTPS。 $host 和 $request_uri 是 Nginx 变量，分别表示主机名和请求 URI。
- error_page 400 /custom_400.html; 定义400错误页面
- location = /custom_400.html 指定400错误页面的位置
注意事项：
- 确保 Nginx 配置文件语法正确，可以使用 nginx -t 命令进行检查。
- 重新加载 Nginx 配置，使更改生效： nginx -s reload。
- 根据实际需求调整 default_server 的配置。例如，可以根据不同的域名或 IP 地址进行不同的处理。
- 如果选择返回自定义错误页面，请确保页面中的资源路径正确，可以使用绝对路径或协议相对路径。
总结
通过配置 default_server，我们可以确保 Nginx 能够正确处理所有 HTTP 请求，即使这些请求尝试访问 HTTPS 端口。 这种方法不仅解决了自定义错误页面资源加载问题，还提高了 Nginx 配置的健壮性和可维护性。 建议在所有 Nginx SSL 配置中都包含 default_server，以确保最佳的用户体验和安全性。
