最推荐方式是使用 return 301 指令在监听 80 端口的 server 块中配置 https://$host$request_uri 跳转，高效、无正则开销、语义清晰；同时必须配置独立的 443 ssl server 块并启用有效证书。
在 Nginx 中实现 HTTP 自动跳转到 HTTPS，最常用、最推荐的方式是使用 return 301（而非 rewrite），因为它更高效、语义更清晰、配置更简洁。虽然标题提到 rewrite，但实际生产环境中应避免用 rewrite ... permanent 做全站跳转，它多一层正则匹配和重写开销，且容易出错。
✅ 推荐方式：用 return 301 实现强制跳转
在 HTTP 服务块（监听 80 端口）中直接返回 301 重定向，指向当前域名的 HTTPS 版本：
server {
listen 80;
server_name example.com www.example.com;
<pre class="brush:php;toolbar:false;"># 强制跳转到 HTTPS，保持原始请求路径和参数
return 301 https://$server_name$request_uri;}
-
$server_name：复用配置中的域名，支持多域名时建议配合
if或拆分为多个 server 块（更安全） -
$request_uri：完整保留路径、查询参数（如
/path?k=v），比$uri?$args更可靠 - 务必确保对应域名已在 HTTPS 的
server块中正确配置 SSL 证书和listen 443 ssl
⚠️ 不推荐方式：用 rewrite 实现跳转（仅作了解）
如果坚持用 rewrite，需注意语法和作用域：
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;"># ❌ 错误：无条件 rewrite /，会丢失路径和参数
# rewrite ^(.*)$ https://$server_name$1 permanent;
# ✅ 可行但冗余（等价于 return）
rewrite ^(.*)$ https://$server_name$1 permanent;}
- 正则
^(.*)$捕获全部路径，$1回填，permanent表示 301 - 问题：正则引擎额外开销；若
server_name为空或未设，可能跳转到错误地址；不处理端口、子路径嵌套等边界情况 - 不支持在
location块外直接用rewrite（Nginx 会报错），必须放在server或location内
? 补充要点：确保 HTTPS 服务正常运行
跳转只是第一步，后端 HTTPS server 必须就绪：
- 监听
443 ssl，配置ssl_certificate和ssl_certificate_key - 建议启用 HSTS（防降级）：
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always; - 若使用 CDN 或反向代理（如 Cloudflare），注意真实客户端 IP 和协议头（
X-Forwarded-Proto），此时跳转逻辑可能需在上层做，或 Nginx 根据头判断：if ($http_x_forwarded_proto = 'http') { return 301 https://$host$request_uri; }（慎用 if，优先用 map）
? 小技巧：批量域名统一跳转
多个域名共用一套跳转逻辑，可用 map 提前映射 HTTPS 主机名：
map $host $https_host {
default $host;
www.example.com example.com;
}
<p>server {
listen 80;
server_name example.com www.example.com;</p><pre class="brush:php;toolbar:false;">return 301 https://$https_host$request_uri;}
- 避免
$server_name在多域名时只取第一个，导致跳转地址不一致 - map 在全局 http 块中定义，性能好且逻辑清晰
