Laravel 表单提交失败的常见原因及 HTTPS 配置修复指南

Laravel 表单（如登录）无响应、Network 显示 301 重定向，往往源于 URL 协议不匹配——当应用部署在 HTTPS 环境但 Laravel 生成的表单 action 仍为 HTTP，浏览器会强制跳转导致 CSRF Token 丢失、请求中断。

laravel 表单提交失败的常见原因及 https 配置修复指南：laravel 表单（如登录）无响应、network 显示 301 重定向，往往源于 url 协议不匹配——当应用部署在 https 环境但 laravel 生成的表单 `action` 仍为 http，浏览器会强制跳转导致 csrf token 丢失、请求中断。

在 Laravel 应用中，表单提交看似“静默失败”（点击无反应、Network 中仅见 301 状态码、.env 数据库错误也不触发），通常并非路由或中间件逻辑问题，而是底层 URL 生成机制与服务器实际协议不一致所致。

关键现象包括：

• 表单 <form action=”http://yoursite.com/login”> 明确使用 http://；
• Chrome Network 面板显示 301 Moved Permanently（而非 200 或 500）；
• _token 字段存在且有效，但请求未抵达控制器（dd() 或日志无输出）；
• 修改 .env 数据库配置无报错 → 证实请求根本未到达 Laravel 应用层。

根本原因在于：Laravel 默认通过 url()、route() 等辅助函数生成 URL 时，依赖 $_SERVER[‘HTTPS’] 或 APP_URL 配置判断协议。若服务器启用 HTTPS 但未正确告知 PHP（例如 Nginx/Apache 未传递 HTTPS=on 或 X-Forwarded-Proto 头），Laravel 仍将生成 http:// 链接，导致浏览器发起 HTTP 请求后被服务器强制 301 重定向至 HTTPS —— 此过程会使 POST 数据和 CSRF Token 丢失，最终请求中断。

✅ 正确解决方案如下：

1. 强制信任代理并启用 HTTPS 检测（推荐，适用于 Nginx/Apache + 反向代理场景）
在 app/Providers/AppServiceProvider.php 的 boot() 方法中添加：

use Illuminate\Http\Request;

public function boot()
{
    if ($this->app->environment('production')) {
        \URL::forceScheme('https');
        $this->app['request']->server->set('HTTPS', 'on');
    }
}

更健壮的做法是配置信任代理（尤其使用 Cloudflare、AWS ALB 或 Nginx 时）：

// 在 AppServiceProvider@boot() 中
if ($this->app->environment('production')) {
    \Illuminate\Http\Request::setTrustedProxies(
        ['127.0.0.1', 'your-load-balancer-ip'],
        \Illuminate\Http\Request::HEADER_X_FORWARDED_ALL
    );
    \URL::forceScheme('https');
}

2. 确保 APP_URL 在 .env 中使用 HTTPS

APP_URL=https://yourdomain.com

⚠️ 注意：仅设置 APP_URL 不足以解决所有场景（如 route() 生成仍可能受服务器变量影响），需配合上述代码。

3. Web 服务器配置校验（以 Nginx 为例）
确保传递 X-Forwarded-Proto 头：

location ~ \.php$ {
    fastcgi_param HTTPS on;                    # 关键：显式声明 HTTPS
    fastcgi_param X-Forwarded-Proto $scheme;
    # 其他 fastcgi_param ...
}

Apache 用户请确认启用了 mod_headers 并添加：

RequestHeader set X-Forwarded-Proto "https" env=HTTPS

✅ 验证效果：
清除缓存后访问页面，检查登录表单 HTML：

<form method="POST" action="https://yourdomain.com/login"> <!-- ✅ 应为 https -->
    <input type="hidden" name="_token" value="...">
</form>

同时在 Chrome DevTools → Network → Headers 中确认 Request URL 为 https://… 且状态码为 200 或 302（而非 301）。

? 小结：Laravel 表单提交失败的“隐形杀手”常是协议不一致。不要急于排查中间件、CSRF 或路由，优先检查 APP_URL、服务器 HTTPS 头传递、以及是否调用 URL::forceScheme(‘https’)。一次正确的协议配置，可避免数小时的无效调试。