品牌更名全站零死链迁移需用nginx return 301实现精准永久跳转：http/https双协议覆盖旧域名，路径结构变更需location或rewrite逐级映射，配置须独立管理并上线前语法校验与curl验证。
品牌更名时实现全站历史链接零死链迁移，核心是让每个旧 URL 都精准、永久、无损地导向语义等价的新 URL。Nginx 的 return 301 是最可靠方式——它不走 rewrite 解析流程，无正则开销，不依赖 location 顺序，跳转发生在请求处理最早阶段，既快又稳。
域名级全量跳转（主场景）
适用于 oldbrand.com → newbrand.com 这类整体更换。必须覆盖所有访问入口：
- 为每个旧域名（含 www 和非 www）单独设
listen 80的 server 块，server_name写明确域名，不要混写或用通配符 -
return 301 https://newbrand.com$request_uri;—— 直接写死 https://，不依赖 $scheme；$request_uri自动保留完整路径和查询参数（如/products/22?utm_medium=social） - 多个旧域名（如 oldbrand.cn、legacy-site.net、www.oldbrand.com）可合并到一个 server 块中，
server_name后空格分隔，Nginx 自动匹配任一命中即跳
HTTPS 旧站必须单独处理
如果用户书签或搜索引擎索引里有 https://oldbrand.com/xxx，只配 HTTP 跳转会卡在证书错误页，导致实际跳转失败：
- 新增一个
listen 443 ssl的 server 块，server_name与 HTTP 块一致 - 配置有效的旧域名 SSL 证书（可用旧证书，或临时续签；通配符/SAN 证书更稳妥）
- 同样用
return 301 https://newbrand.com$request_uri;，协议保持一致，避免混合内容或跳转链断裂 - 切勿在 HTTPS 块中 return http://，浏览器会拦截不安全跳转
路径结构调整需逐级映射
仅靠域名跳转不够——若品牌升级同时调整了 URL 结构（如 /about-us → /company，/blog/post/123 → /articles/123），必须补充页面级或目录级规则：
- 单页迁移：用
location = /old-page.html { return 301 /new-page.html?$args; }，=表示精确匹配，$args显式保留查询参数 - 目录迁移：用
location ^~ /old-dir/ { rewrite ^/old-dir/(.*)$ /new-dir/$1 permanent; }，^~前缀匹配优先于正则，避免冲突 - 后缀清理或格式统一：如
.php去除、大小写标准化，建议用 rewrite + permanent，并锚定正则（^和$）防止误匹配
配置管理与上线验证
跳转规则不能散落在主配置或站点文件里，否则难维护、易出错：
- 把所有跳转 server 块抽成独立文件，例如
/etc/nginx/conf.d/redirects-old-to-new.conf - 在主配置
http { }块末尾加include /etc/nginx/conf.d/redirects-old-to-new.conf;，便于测试时注释整段快速回滚 - 上线前必做三步：
nginx -t检语法、curl -I http://oldbrand.com/test和curl -I https://oldbrand.com/test看响应头是否含301 Moved Permanently及正确Location、清浏览器缓存或先用 302 测试逻辑
