nginx重定向自定义状态码需区分裸配置与ingress场景：裸nginx用return 308指令，ingress需注解permanent-redirect-code设为"308"并配permanent-redirect目标；308常因ingress升级或路径规范化被动触发，须用curl验证响应头及location字段。
配置 Nginx 在重定向时使用自定义状态码（比如 308），关键在于明确使用场景：是直接在 Nginx 配置文件中用 return 或 rewrite 指令，还是在 Kubernetes 中通过 Nginx Ingress Controller 的注解控制。两者机制不同，不能混用。
直接在 Nginx 配置中返回 308
适用于裸 Nginx 或自建反向代理场景。Nginx 原生支持 return 指令指定任意 3xx 状态码及目标 URL：
-
return 308 https://example.com$request_uri;—— 返回 308，并携带原始路径 -
return 308 https://api.example.com$uri;—— 注意$uri不含 query string，需手动拼接$args - 必须确保目标 URL 是完整、合法的绝对地址（含协议和域名），否则 Nginx 启动会报错
- 该指令只能放在
server或location块内，不支持在if块中用于 308（部分旧版本有兼容限制）
在 Nginx Ingress 中设置永久重定向为 308
Kubernetes 环境下，Ingress 默认的 permanent-redirect 注解发出的是 301；若需强制用 308，必须显式指定状态码：
- 添加注解：
nginx.ingress.kubernetes.io/permanent-redirect-code: "308" - 同时保留重定向目标注解：
nginx.ingress.kubernetes.io/permanent-redirect: "https://new.example.com" - 注意引号：YAML 中数字字符串需加引号，否则会被解析为整型导致解析失败
- 该组合仅对根路径或匹配的
path: /生效；如需路径级重定向（如 /old → /new），应改用rewrite-target+return或 service backend 重写逻辑
为什么有时会“意外”出现 308？
并非所有 308 都是主动配置的。常见被动触发原因包括：
- Nginx Ingress 升级后默认行为变更：v1.0+ 版本将永久重定向默认码从 301 改为 308，老 IE 或某些 Java 客户端可能不识别
- 路径规范化：访问
/user//profile（双斜杠）或/User/Profile（大小写不一致），Nginx 自动标准化并返回 308 - 客户端发起非 GET 请求（如 POST）且服务端配置了路径修正规则，Nginx 为保持方法安全而选用 308
验证与调试要点
配置生效后，务必通过真实请求验证响应头，而非仅看浏览器跳转结果：
- 用
curl -I -X POST http://your-domain/api/v1/old检查是否返回308及正确Location头 - 确认响应中包含
Location: https://...，这是 308 的强制要求，缺失则说明配置未生效或被覆盖 - 检查 access log，确认状态码字段确实是
308，排除中间层（如 CDN、LB）覆盖响应的可能 - 若客户端不支持 308（如旧版 IE、部分 JDK HttpURLConnection），应降级为 301 并评估业务影响
