如何在 Nginx 服务器中配置 301 跳转？常见问题及解决方法？
在网站运维中，301跳转常用于域名变更、SEO优化或统一访问入口（如带www与不带www的统一）。以下是关于 Nginx 服务器配置 301 跳转的思路和注意事项：
通过合理配置 Nginx 的 301 跳转规则，可以有效提升网站的SEO表现和用户体验。建议在正式上线前使用在线工具测试跳转是否正常，例如使用 Redirect Checker 进行验证。
1. 常见 301 跳转需求及配置示例
| 需求类型 | 示例说明 | 配置代码 |
|---|---|---|
| 不带 www 跳转到带 www | example.com → www.example.com |
server {<br> listen 80;<br> server_name example.com;<br> return 301 http://www.example.com$request_uri;<br>} |
| 带 www 跳转到不带 www | www.example.com → example.com |
server {<br> listen 80;<br> server_name www.example.com;<br> return 301 http://example.com$request_uri;<br>} |
| HTTP 跳转 HTTPS | http://example.com → https://example.com |
server {<br> listen 80;<br> server_name example.com;<br> return 301 https://$host$request_uri;<br>} |
| 多个旧域名跳转到新域名 | old.com → new.com |
server {<br> listen 80;<br> server_name old.com www.old.com;<br> return 301 http://new.com$request_uri;<br>} |
2. 注意事项
- 避免循环跳转：确保跳转规则不会形成死循环（如 A→B→A）。
- 保留路径和参数：使用
$request_uri可确保跳转时保留原路径和查询参数，利于SEO。 - HTTPS跳转需配置SSL证书：若配置了 HTTPS 的 301 跳转，需确保证书已正确安装并监听443端口。
3. 常见问题排查
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 跳转未生效 | 配置语法错误或未重载服务 | 执行 nginx -t 检查配置，并执行 systemctl reload nginx |
| 出现 500 错误 | 配置格式错误或变量使用不当 | 检查是否遗漏分号或变量拼写错误 |
| 浏览器缓存旧跳转 | 浏览器缓存了301记录 | 使用隐身模式访问或清除浏览器缓存 |
| 多站点配置冲突 | 多个server块匹配了同一个域名 | 检查 server_name 设置优先级 |
通过合理配置 Nginx 的 301 跳转规则，可以有效提升网站的SEO表现和用户体验。建议在正式上线前使用在线工具测试跳转是否正常，例如使用 Redirect Checker 进行验证。
更新时间：2025-05-15 19:04:34