.htaccess在本地XAMPP可用但线上失效：Nginx将POST请求转为GET

当前架构下POST请求被篡改的核心诱因基本都出在Nginx代理层的规则配置上，可按以下步骤调整：

• 定位导致方法篡改的常见配置
• 排查是否存在用301/302状态码做全局http转https跳转的规则：这类跳转属于客户端重定向，HTTP协议规定301/302跳转默认会把POST请求的方法强制改成GET，是该类问题最高发的诱因。
• 排查是否存在未透传原始请求方法的代理配置：部分自定义代理逻辑会覆盖原始请求方法值，导致后端Apache接收不到真实的POST请求标识。
• /api路径专用的安全代理配置示例（完整保留POST方法）

# 单独匹配/api路径的代理规则，避免被全局跳转规则影响
location ^~ /api/ {
    # 转发请求到后端Apache服务的api目录
    proxy_pass http://[你的后端Apache服务地址]/api/;

    # 所有涉及跳转的场景强制使用307状态码，完全保留原始请求方法与请求体
    proxy_redirect =http://你的站点域名 https://你的站点域名/ permanent;
    error_page 301 302 = @post_safe_redirect;

    # 核心透传配置，不篡改原始请求信息
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Original-Request-Method $request_method;
    # 关闭不必要的请求缓冲，避免请求体丢失
    proxy_request_buffering off;
}

# 定义兼容POST请求的跳转处理块，替代默认的301/302跳转
location @post_safe_redirect {
    proxy_pass http://[你的后端Apache服务地址];
    proxy_set_header X-Original-Request-Method $request_method;
    proxy_redirect off;
}

• 配置关键点说明
• 所有针对POST请求的跳转场景，必须替换301/302为307（临时跳转）或308（永久跳转），这类状态码不会强制篡改原始请求方法，是适配REST接口的标准跳转配置。
• 不要在Nginx层给/api路径添加任何rewrite重写规则，所有URL重写逻辑统一交由api目录下的Apache .htaccess处理，避免Nginx层触发的客户端跳转破坏POST请求链路。

在Nginx配置调整完成后，可通过以下步骤验证链路可用性：

• 保留你当前在api目录下的.htaccess规则：RewriteEngine on RewriteCond %{REQUEST_FILENAME} !-f RewriteRule . index.php [L]，该规则属于服务端内部重写，不会触发客户端跳转，本身不会篡改POST请求方法，可直接使用。
• 临时在api/index.php顶部添加调试代码，验证接收到的请求信息：

// 临时调试代码
header('Content-Type: application/json');
echo json_encode([
    'current_request_method' => $_SERVER['REQUEST_METHOD'],
    'post_data' => $_POST
]);
exit;

用POST请求访问对应接口地址，如果返回的current_request_method值为POST，说明透传链路正常，移除调试代码即可接入原有AltoRouter的路由逻辑。

• 排查Apache侧的重写规则：如果api目录的.htaccess中存在带[R]参数的跳转规则，需要将跳转状态码调整为307/308，避免层叠的方法篡改问题。

• 全局http转https规则不要直接覆盖/api路径：如果全局80端口跳443端口的规则使用301状态码，会拦截所有POST请求并强制转为GET，必须单独给/api路径的跳转配置307状态码，保证POST方法不丢失。
• 关闭Nginx的post_action配置：该配置会在POST请求处理完成后自动触发GET方法的重定向，是另一类常见的POST被转GET的诱因。
• 如果无法自主修改主机的Nginx配置，可联系服务商将/api路径的代理规则从通用站点代理规则中剥离，配置为原生透传模式，关闭代理层的自动重定向、方法重写逻辑。

内容的提问来源于stack exchange，提问作者manuel