计算机网络 / 系统课时
使用重定向状态码
使用重定向状态码
重定向不只是“换一个 URL”。301、302、303、307、308 会影响客户端是否把原请求方法和请求体带到新地址。选错状态码,常见后果是 POST 被改成 GET,或本应临时的跳转被当成永久迁移。
学习目标
- 能根据“永久或临时”和“是否必须保留方法”选择 301、302、303、307、308。
- 能用
curl验证 POST 在不同重定向状态码下的方法变化。 - 能识别
Location、客户端行为和重定向循环等边界问题。
五种状态码怎么选
先判断目标地址是永久替代还是临时替代,再判断跳转后是否必须保留原方法与请求体。对于 POST,301 和 302 允许用户代理出于历史兼容把后续请求改成 GET,因此不能用它们承诺“方法一定不变”。
| 状态码 | 典型含义 | 后续方法处理 | 常见用途 |
|---|---|---|---|
| 301 Moved Permanently | 资源永久迁移 | POST 可能改为 GET | 旧页面永久换址 |
| 302 Found | 临时跳转 | POST 可能改为 GET | 临时替代地址 |
| 303 See Other | 到另一个 URI 获取结果 | 通常使用 GET | POST 后显示结果页 |
| 307 Temporary Redirect | 临时跳转 | 保留方法与请求体 | 临时迁移 API 写请求 |
| 308 Permanent Redirect | 永久跳转 | 保留方法与请求体 | 永久迁移 API 写请求 |

如果需求是“表单提交成功后显示结果页”,303 的意图最清楚;如果 API 临时切流且 PUT、PATCH、POST 不能改变,就用 307;永久迁移且仍要保留方法,则使用 308。
用本地服务验证方法是否改变
下面的 Python 3 脚本提供 /start/<code> 和 /target。前者返回指定重定向状态并设置 Location: /target,后者回显最终收到的方法与请求体,可以直接观察不同状态码的差异。
from http.server import BaseHTTPRequestHandler, HTTPServer
class Handler(BaseHTTPRequestHandler):
def log_message(self, format, *args):
pass
def reply(self, status, body=b'', location=None):
self.send_response(status)
if location:
self.send_header('Location', location)
self.send_header('Content-Length', str(len(body)))
self.end_headers()
self.wfile.write(body)
def do_POST(self):
length = int(self.headers.get('Content-Length', '0'))
body = self.rfile.read(length)
if self.path.startswith('/start/'):
code = int(self.path.rsplit('/', 1)[1])
self.reply(code, location='/target')
return
self.reply(200, f'method=POST body={body.decode()}'.encode())
def do_GET(self):
self.reply(200, b'method=GET body=')
if __name__ == '__main__':
print('listening on http://127.0.0.1:8000')
HTTPServer(('127.0.0.1', 8000), Handler).serve_forever()预期输出:
listening on http://127.0.0.1:8000保持服务运行,在另一个终端执行以下命令。不要额外添加 -X POST,因为强制指定方法会掩盖客户端原本的重定向处理行为。
for code in 301 302 303 307 308; do printf '%s -> ' "$code"; curl -s -L -d 'name=alice' "http://127.0.0.1:8000/start/$code"; printf '\n'; done预期输出:
301 -> method=GET body=
302 -> method=GET body=
303 -> method=GET body=
307 -> method=POST body=name=alice
308 -> method=POST body=name=alice这里展示的是 curl 的默认重定向行为。301、302 对 POST 的改写属于历史兼容行为,不应据此假定所有客户端都必须完全一致;真正要求方法和请求体保持不变时,应直接选择 307 或 308。
实际接口怎么避免踩坑
重定向响应通常通过 Location 指向新 URI。迁移 API 写接口时,不要仅因为“301 更常见”就使用 301。例如 POST /payments 临时切到新集群,应返回 307;确认永久迁移后才改成 308。
验收重定向时至少检查最终 URL、最终方法、请求体是否保留以及是否形成循环。浏览器、SDK、反向代理和命令行客户端还可能采用不同的自动跟随策略,因此写接口时应依赖状态码语义,而不是依赖某一个客户端的偶然表现。