多环境切换应通过域名区分+hosts绑定+反向代理实现：为dev.local、staging.local、api.dev.local等域名配置本地hosts解析，并在nginx/conf.d下分环境配置独立conf文件，proxy_pass指向对应本地端口，注意proxy_pass末尾不加/，切换环境只需修改浏览器地址栏即可。
多环境切换时配 Nginx 虚拟主机，关键不是堆一堆 server 块，而是让每个环境有独立、可识别、易切换的访问入口，同时不干扰彼此。核心思路是：用域名区分环境 + 本地 hosts 绑定 + 反向代理转发到对应端口服务。
域名与本地解析必须先对齐
浏览器不认识 dev.local 或 staging.myapp.com，除非你告诉它这些名字指向本机。
编辑系统 hosts 文件（Linux/macOS /etc/hosts，Windows C:\Windows\System32\drivers\etc\hosts），加这几行：
127.0.0.1 dev.local 127.0.0.1 staging.local 127.0.0.1 api.dev.local
保存后执行 ping dev.local 确认能通；Windows 还建议运行 ipconfig /flushdns 清缓存。这一步漏了，后面全白配。
每个环境单独一个 conf 文件
别把所有配置塞进 nginx.conf，推荐放在 /etc/nginx/conf.d/ 下，按环境命名，比如：
-
dev.local.conf→ 转发到前端本地开发服务（如localhost:3000） -
staging.local.conf→ 转发到模拟预发环境（如localhost:5000） -
api.dev.local.conf→ 转发到本地 mock API 或调试后端（如localhost:8080）
每个文件内容结构一致，以 dev.local.conf 为例：
server {
listen 80;
server_name dev.local;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
⚠️注意：proxy_pass 后面不要加 /（即写 http://127.0.0.1:3000，不是 http://127.0.0.1:3000/），否则路径会被截断重写；如果后端服务挂载在子路径（比如 /admin），需额外加 rewrite 或调整 location 匹配规则。
切换环境只需改浏览器地址栏
配好之后，不用重启服务、不用改代码、也不用动端口：
- 访问
http://dev.local→ 对应本地:3000前端 - 访问
http://staging.local→ 对应本地:5000预发版 - 访问
http://api.dev.local→ 对应本地:8080接口服务
各环境完全隔离，前端代码里请求 api.dev.local/users 就自动走本地代理，无需硬编码 localhost:8080，也避免跨域问题。
验证和快速排错顺序
配完别急着刷页面，按这个顺序检查：
- 确认目标服务已启动：
curl -I http://localhost:3000应返回200 OK - 检查 Nginx 配置语法：
sudo nginx -t，提示 “syntax is ok” 才安全 - 重载配置生效：
sudo nginx -s reload（不是 restart） - 查错误日志定位：
tail -f /var/log/nginx/error.log，常见报错包括：-
connect() failed (111: Connection refused)→ 后端没起来或端口错 -
no resolver defined to resolve ...→proxy_pass写了域名但没配 resolver（本地用127.0.0.1就不用） -
host not found in upstream→server_name和 hosts 不匹配，或拼写大小写不一致
-
不复杂但容易忽略细节。
