计算机网络 / 系统课时

使用重定向状态码

使用重定向状态码

重定向不只是“换一个 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 写请求

301、302、303、307、308 的方法处理差异

如果需求是“表单提交成功后显示结果页”,303 的意图最清楚;如果 API 临时切流且 PUT、PATCH、POST 不能改变,就用 307;永久迁移且仍要保留方法,则使用 308。

用本地服务验证方法是否改变

下面的 Python 3 脚本提供 /start/<code> 和 /target。前者返回指定重定向状态并设置 Location: /target,后者回显最终收到的方法与请求体,可以直接观察不同状态码的差异。

python
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()

预期输出:

text
listening on http://127.0.0.1:8000

保持服务运行,在另一个终端执行以下命令。不要额外添加 -X POST,因为强制指定方法会掩盖客户端原本的重定向处理行为。

bash
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

预期输出:

text
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、反向代理和命令行客户端还可能采用不同的自动跟随策略,因此写接口时应依赖状态码语义,而不是依赖某一个客户端的偶然表现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用重定向状态码

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通