优雅平滑下线nginx virtual host需渐进式隔离流量：1.用301/302重定向替代删除；2.配合upstream健康检查灰度摘除后端；3.用map+if实现请求级拦截并审计；4.注释后观察24–48小时再清理配置。
在生产环境中优雅平滑地下线 Nginx 的某个 Virtual Host（即某个域名站点），核心原则是：不中断现有用户请求、不引发 502/503 错误、不依赖重启、避免 DNS 生效延迟带来的风险。关键不是“删配置”，而是“渐进式隔离流量 + 状态可观测 + 安全兜底”。
1. 用 return 301 或 302 临时重定向替代直接删除
这是最常用也最安全的第一步。修改该 server 块，将所有请求导向新地址或维护页，同时保留旧配置结构：
- 若已迁移至新域名（如 old.example.com → new.example.com），用 return 301 https://new.example.com$request_uri;，确保 SEO 友好且浏览器缓存可接受
- 若暂无替代服务，返回一个轻量级维护页：return 302 /maintenance.html;，并在 root 下放置静态 HTML 文件
- 切勿用 404 或 444 直接切断——老链接可能还在邮件、文档、第三方引用中，突然失效易被投诉
2. 配合 upstream 健康检查做灰度下线（适用于反向代理场景）
如果该 Virtual Host 后端是 proxy_pass 到一组应用实例，可借助 Nginx Plus 或开源版的健康检查能力逐步摘除节点：
- 在 upstream 块中启用 max_fails=1 fail_timeout=10s，并为后端加 health_check interval=5 uri=/health（需编译含 http_upstream_health_check_module）
- 先对目标后端服务主动返回 503 或非 200 响应，Nginx 会自动将其标记为 down，流量自然转移
- 观察 access.log 和 $upstream_addr，确认无请求再落到该后端，再执行下一步
3. 用 map + if 实现请求级条件拦截（适合需保留日志审计的场景）
当需要记录下线期间所有访问、但又不允许响应内容时，可用 map 构建开关变量：
- 在 http 块中定义：map $host $should_decommission { default 0; old.example.com 1; }
- 在对应 server 块内加：if ($should_decommission) { return 451 "Site retired"; }（451 表示“因法律原因不可用”，语义比 404 更明确）
- 配合 log_format 记录 $should_decommission 字段，便于后续统计访问来源和频率，判断是否还有残留调用方
4. 最终清理与验证步骤
确认无有效流量后，再执行配置清理，避免误删或遗漏：
- 先注释掉整个 server 块（不要删），reload Nginx；观察 24–48 小时监控（QPS、5xx、access 日志 grep old.example.com）
- 确认零请求后，再从配置文件中彻底移除该 server，并运行 nginx -t 校验语法
- 更新部署脚本或 IaC 模板（如 Ansible、Terraform），防止下次发布时重新生成该配置
- 通知相关方（如 CDN、监控系统、SRE 团队）同步下线状态，关闭对应告警规则
