proxy_redirect default 不自动补全路径，仅重写后端返回的 Location 响应头；路径补全由 location 与 proxy_pass 末尾斜杠协同实现：proxy_pass 后带斜杠时，Nginx 替换路径前缀并配合 proxy_redirect 补全重定向 URL。
在 Nginx 中，proxy_redirect default 本身**不会自动补全路径**，它只是启用默认的重定向地址重写规则。所谓“利用 location 块完成路径补全”，实际依赖的是 location 的匹配逻辑 + proxy_pass 的末尾斜杠行为，而非 proxy_redirect 主动补全。关键在于正确配置 proxy_pass 和理解 proxy_redirect 的作用边界。
理解 proxy_redirect default 的真实作用
proxy_redirect default 是一种快捷写法，等价于：
- 当
proxy_pass指向带路径的后端（如http://127.0.0.1:8080/api/）时，它会自动将后端返回的Location: /api/xxx重写为客户端可见的完整 URL（如https://example.com/api/xxx）； - 但它**不修改请求路径、不拼接 location 路径、也不补全缺失的斜杠**；
- 它的触发前提是后端响应中包含
Location头（如 301/302 重定向），且该头值是相对路径或绝对路径。
真正实现“路径补全”的核心：proxy_pass 末尾斜杠规则
路径是否被补全，取决于 location 和 proxy_pass 的组合方式。这才是你想要的“自动补全”机制：
-
写法 A（推荐）：
location /api/ { proxy_pass http://backend/; }
→ 客户端请求/api/user，Nginx 将/api/替换为/，转发给后端/user；后端若返回Location: /user/profile，proxy_redirect default会将其映射为https://host/api/user/profile（自动补上前缀）； -
写法 B（易错）：
location /api/ { proxy_pass http://backend; }
→ 客户端请求/api/user，Nginx 直接转发完整路径/api/user给后端；后端看到的是带前缀的路径，可能无法识别，也无法自然触发路径补全；
✅ 正确使用斜杠，才是让 Nginx “感知 location 上下文并补全路径”的根本方式。
配合 proxy_redirect 实现重定向路径修正
当后端返回重定向且路径不含 host 时，proxy_redirect default 才起效。例如：
- 客户端访问
https://example.com/api/login； - Nginx 匹配
location /api/ { proxy_pass http://srv/; }，转发为/login； - 后端处理后返回
302 Location: /dashboard； -
proxy_redirect default自动将其改写为https://example.com/api/dashboard（补上/api/前缀）；
⚠️ 若后端返回的是 Location: https://backend.example.com/dashboard（含完整协议+域名），则 default 不生效，需显式配置：proxy_redirect https://backend.example.com/ https://example.com/api/;
常见陷阱与检查项
-
location /api（无末尾斜杠）和location /api/行为完全不同——前者会匹配/apixxx，后者才精准匹配目录； -
proxy_pass后的 URL 末尾斜杠必须与location语义对齐，否则路径替换失败； -
proxy_redirect default只处理响应头，不影响请求路径；路径补全是proxy_pass+location协同完成的； - 调试时可用
curl -I查看后端原始Location头，并对比 Nginx 返回的实际头，验证重写是否生效。
