curl--post301选项详解让 POST 请求在 301 重定向后保持 POST 方法【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl--post301是 curl 命令行工具中用于控制 HTTP 重定向行为的关键选项当服务器返回301 Moved Permanently且 curl 在--location模式下跟随重定向时默认会按浏览器习惯把 POST 请求改写为 GET而--post301可以强制 curl 遵循 RFC 7231 6.4.2 的规范让 POST 在重定向后依然是 POST。本文结合 curl 仓库源码lib/http.c、lib/setopt.c、include/curl/curl.h与测试用例tests/data/test1012、tests/data/test1054完整讲解该选项的语义、默认行为、底层实现与 libcurl 编程等价物。选项速览--post301的完整定义位于 docs/cmdline-opts/post301.md其命令行元数据如下属性值Long 名称--post301Help 文本Do not switch to GET after a 301 redirect适用协议HTTP加入版本7.17.1类别http postMultiboolean可多次出现与其他布尔选项行为一致相关选项--post302、--post303、--location官方示例--post301 --location -d data $URL该选项的官方语义为遵循 RFC 7231 的 6.4.2 节在跟随 301 重定向时不把 POST 请求转换为 GET 请求。文档同时指出非 RFC 行为在 Web 浏览器中无处不在几乎所有的浏览器都会在 301/302 后把 POST 改写为 GET因此 curl 默认执行转换以与浏览器保持一致但某些服务器可能要求 POST 在重定向后仍然是 POST此时就需要--post301。该选项只有在配合--location-L使用时才有意义——没有重定向跟随自然也就不存在重定向前后方法切换的问题。背景为什么 curl 默认把 POST 改成 GET要理解--post301必须先理解 curl 的重定向处理机制。当服务器返回 3xx 状态码并携带Location:响应头时--location会让 curl 向新地址重新发起请求参见 docs/cmdline-opts/location.md。对于 301、302、303 这三类状态码curl 的默认策略是如果当前请求是 POST则把后续请求切换为 GET而对其他 3xx 状态码如 307 Temporary Redirect、308 Permanent Redirectcurl 会用未修改的原始方法重新发送请求。--location文档中对此有明确描述When curl follows a redirect and if the request is a POST, it sends the following request with a GET if the HTTP response was 301, 302, or 303. If the response code was any other 3xx code, curl resends the following request using the same unmodified method.这一默认行为的成因在 lib/http.c 的Curl_http_follow函数中有详细注释301/302 的历史语义允许用户代理将 POST 改为 GET而现实中大量 Web 服务器期望这种转换因此 libcurl 强制使用 GET以便拿到与主流用户代理一致的结果。代码注释还指出这一行为被 RFC1945 和已废弃的 RFC2616 所禁止但可以通过CURLOPT_POSTREDIR覆盖。301/302/303 与 307/308 的对比状态码RFC 依据curl 默认行为保持 POST 的选项301 Moved PermanentlyRFC 7231 6.4.2POST → GET--post301302 FoundRFC 7231 6.4.3POST → GET--post302303 See OtherRFC 7231 6.4.4POST → GET--post303307 Temporary RedirectRFC 7231 6.4.7保持原方法无需选项308 Permanent RedirectRFC 7538保持原方法无需选项有趣的是--post301、--post302、--post303三个选项的措辞略有差异前两者是Respect RFC … and do not convert遵循 RFC不转换而--post303是Violate RFC … and do not convert违反 RFC不转换——因为对于 303RFC 规范本身就要求把方法改为 GETSee Other表示 Location 指向的是原资源的替代展示而非资源本身所以强制保留 POST 反而是对规范的偏离详见 docs/cmdline-opts/post303.md。命令行用法与实战示例基本用法--post301是布尔开关无参数值与--location搭配使用# 跟随 301 重定向且重定向后的请求仍然使用 POST curl --post301 --location -d data $URL # 简写形式 curl -L --post301 -d data $URL让所有常见重定向都保持 POST如果要让 POST 在 301、302、303 三类重定向下都保持不变可以组合使用三个选项curl --post301 --post302 --post303 --location -d data $URL与--request-X的交互--location文档明确指出用--request设置的方法会覆盖 curl 原本会选用的方法。也就是说如果重定向后 curl 准备切换为 GET但你在命令行上用-X POST强制指定了方法那么后续请求仍会是 POST。在实际使用中--post301与显式-X POST的效果可以叠加但语义上--post301更精准——它只影响重定向场景不会干扰其他请求。一个完整的可复现示例假设$URL指向一个返回301加Location:头的服务端点# 默认行为第一次是 POST跟随 301 后第二次请求变成 GET curl -v -L -d moo $URL # 使用 --post301两次请求都是 POST请求体 moo 会被重新发送 curl -v -L --post301 -d moo $URL源码级原理--post301的完整调用链--post301从命令行参数到实际生效贯穿了 curl 的 CLI 层与 libcurl 库层完整链路如下命令行解析在 src/tool_getparam.c 中注册参数名{post301, ARG_BOOL, , C_POST301}命中后在case C_POST301src/tool_getparam.c写入config-post301 toggle其中toggle由布尔参数的--post301/--no-post301形式决定。配置存储字段定义在 src/tool_cfgable.h 的struct GlobalConfig中为位域BIT(post301)。转换为 libcurl 选项在 src/config2setopts.c 中if(config-post301)将命令行配置映射为 libcurl 的CURLOPT_POSTREDIR并 OR 上CURL_REDIR_POST_301位。libcurl 存储lib/setopt.c 处理CURLOPT_POSTREDIR通过位运算拆解到三个独立的状态位s-post301 !!(arg CURL_REDIR_POST_301)、s-post302、s-post303。这三个状态位定义在 lib/urldata.h。重定向时生效lib/http.c 的Curl_http_follow在收到 301 响应后判断if(HTTPREQ_IS_POST(data) !data-set.post301)时才会调用http_switch_to_get(data, 301)把请求方法改为 GET反之当post301为真时跳过转换保持 POST。Curl_http_follow中的核心判断在 lib/http.c 中三个状态码的处理逻辑如下case 301: /* Moved Permanently */ if(HTTPREQ_IS_POST(data) !data-set.post301) { http_switch_to_get(data, 301); switch_to_get TRUE; } break; case 302: /* Found */ if(HTTPREQ_IS_POST(data) !data-set.post302) { http_switch_to_get(data, 302); switch_to_get TRUE; } break; case 303: /* See Other */ if(!HTTPREQ_IS_POST(data) || !data-set.post303) { http_switch_to_get(data, 303); switch_to_get TRUE; } break;注意 303 分支的差异--post303的语义是即使规范要求切换为 GET 也要保持 POST所以判断条件是!HTTPREQ_IS_POST(data) || !data-set.post303——只有当请求本身不是 POST或者用户明确设置了post303时才不进行方法切换。而HTTPREQ_IS_POST宏lib/http.c覆盖了三种 POST 形式HTTPREQ_POST、HTTPREQ_POST_FORM-F表单与HTTPREQ_POST_MIME。http_switch_to_get做了什么当确实需要切换方法时lib/http.c 的http_switch_to_get完成以下工作static void http_switch_to_get(struct Curl_easy *data, int code) { const char *req CURL_EASY_STR(data, STRING_CUSTOMREQUEST); if((req ||>/* symbols to use with CURLOPT_POSTREDIR. CURL_REDIR_POST_301, CURL_REDIR_POST_302 and CURL_REDIR_POST_303 can be bitwise ORed so that CURL_REDIR_POST_301 | CURL_REDIR_POST_302 | CURL_REDIR_POST_303 CURL_REDIR_POST_ALL */ #define CURL_REDIR_GET_ALL 0L #define CURL_REDIR_POST_301 1L #define CURL_REDIR_POST_302 2L #define CURL_REDIR_POST_303 4L #define CURL_REDIR_POST_ALL \ (CURL_REDIR_POST_301 | CURL_REDIR_POST_302 | CURL_REDIR_POST_303)对应的 C 代码写法CURL *curl curl_easy_init(); curl_easy_setopt(curl, CURLOPT_URL, url); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data); curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L); /* 等价于命令行 --post301 */ curl_easy_setopt(curl, CURLOPT_POSTREDIR, CURL_REDIR_POST_301); /* 等价于 --post301 --post302 --post303 的组合 */ curl_easy_setopt(curl, CURLOPT_POSTREDIR, CURL_REDIR_POST_ALL);CURL_REDIR_GET_ALL值 0表示全部切换为 GET即默认行为。注意 lib/setopt.c 会校验参数当传入值小于CURL_REDIR_GET_ALL即负数时curl_easy_setopt会返回CURLE_BAD_FUNCTION_ARGUMENT错误。此外lib/easyoptions.c 中还存在POST301这个别名它同样映射到CURLOPT_POSTREDIR供以选项名编程如curl_easy_setopt的字符串形式或其他语言的绑定层时使用。测试用例验证curl 仓库的集成测试直接验证了--post301的行为可对照查看tests/data/test1012名为 HTTP POST with 301 redirect and --post301测试命令为http://%HOSTIP:%HTTPPORT/blah/%TESTNUMBER -L -d moo --post301。其protocol校验段显示重定向前后的两次请求都是 POST且均携带Content-Length: 3与请求体moo证明 301 后 POST 方法及请求体都被完整保留。tests/data/test1054名为 HTTP POST from file with 301 redirect and --post301验证从文件读取请求体-d file的场景命令-L -d %LOGDIR/test%TESTNUMBER.txt --post301下重定向前后两次请求同样是 POST请求体fielddata被重新发送。这两个用例从客户端与服务端两侧共同确认启用--post301后curl 会向重定向目标重新发送完整的 POST 请求包括请求体而不是像默认那样降级为无请求体的 GET。使用注意事项小结--post301仅在配合--location/-L时生效单独使用无任何效果该选项只针对301状态码302 用--post302303 用--post303307/308 默认就保持原方法无需处理保持 POST 意味着请求体会被重新发送因此上传数据必须可回卷可重读对一次性数据流如某些实时管道输入重定向跟随可能失败若服务器实际期望的是保持方法语义也可以考虑直接改用 307/308 状态码让服务端与客户端都获得更明确的语义参见 lib/http.c 中引用的 RFC 原文在 libcurl 编程中用CURLOPT_POSTREDIR配合CURL_REDIR_POST_301或按位 OR 组合即可获得与命令行完全一致的行为。相关文档索引--location 重定向跟随总览--post302302 重定向后保持 POST--post303303 重定向后保持 POST--request覆盖请求方法--max-redirs限制跟随重定向次数--location-trusted跨主机传递凭据libcurl 重定向相关头文件定义【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考