497是Nginx内部生成的非标准状态码，表示HTTP请求误入仅监听HTTPS的server块；需在该server块内用error_page 497配合return 301实现自动跳转，不可在HTTP server中配置或混用rewrite。
497 是 Nginx 自定义的非标准状态码，表示客户端使用 HTTP 协议访问了本应只接受 HTTPS 的虚拟主机（即启用了 ssl on 或配置了 listen ... ssl 的 server 块）。当用户误输 http:// 地址却命中了仅监听 HTTPS 的 server 时，Nginx 默认返回 497 错误页。这不是用户友好的行为——应自动跳转到对应 HTTPS 地址，而非显示错误。
理解 497 触发条件与 error_page 作用机制
497 不是客户端发起的请求状态，而是 Nginx 在 SSL 握手前就发现“该 server 块要求 HTTPS，但收到的是纯 HTTP 请求”时内部生成的状态。它发生在请求解析早期，早于 location 匹配。因此，error_page 497 必须定义在 触发 497 的那个 server 块内（通常是只监听 HTTPS 端口、但被 HTTP 请求意外打中的 server），且需配合 return 301 或 rewrite 实现重定向。
基础平滑重定向配置（推荐 return 方式）
在仅监听 HTTPS 的 server 块中添加：
server {
listen 443 ssl;
server_name example.com;
<pre class="brush:php;toolbar:false;"># SSL 配置省略...
# 关键：捕获 497 并 301 跳转到 HTTPS 版本
error_page 497 =301 https://$host$request_uri;
}
说明：
-
=301表示将错误响应直接替换为 301 响应，不走默认错误页流程； -
https://$host$request_uri精确还原原始请求的域名和完整路径（含查询参数），保证语义一致； - 务必确保该 server 块中 没有其他 server 块监听同一 IP:Port 的 HTTP 流量，否则请求可能被另一个 server 拦截，根本不会触发 497。
处理 Host 头缺失或需强制主域名的场景
若希望统一跳转到带 www 或固定域名（如强制 https://www.example.com），不能仅靠 $host。可在 error_page 后使用 named location 配合 return：
server {
listen 443 ssl;
server_name example.com www.example.com;
<pre class="brush:php;toolbar:false;">ssl_certificate ...;
ssl_certificate_key ...;
error_page 497 @https_redirect;
location @https_redirect {
return 301 https://www.example.com$request_uri;
}
}
这样可完全控制跳转目标，避免因客户端发送的 Host 头不可信（如空、伪造）导致跳转异常。
避免常见陷阱
- 不要在 HTTP server 块中配 497：HTTP server 不会生成 497，配了也无效；
- 勿混用 rewrite 和 error_page 497：rewrite 发生在 location 阶段，而 497 在更早阶段触发，rewrite 对它不起作用；
-
检查端口监听是否冲突：确保没有另一个 server 监听
listen 80或listen *:80却未处理该域名——否则 HTTP 请求会被它吃掉，497 根本不会出现； - 测试时用 curl -v http://...，不要只看浏览器，因浏览器可能缓存 301 或自动升级；
配置简洁、语义明确，无需额外模块，是解决 HTTPS 强制跳转最轻量可靠的方式之一。
