laravel 部署到子路径（如 example.com/app/my-app）后，auth 中间件仍跳转至 localhost:8000/login，根本原因是 laravel 未正确解析当前请求上下文中的基础 url，需从 app_url、url 生成机制及中间件行为三方面协同修复。
laravel 部署到子路径（如 example.com/app/my-app）后，auth 中间件仍跳转至 localhost:8000/login，根本原因是 laravel 未正确解析当前请求上下文中的基础 url，需从 app_url、url 生成机制及中间件行为三方面协同修复。
在 Laravel 应用部署于反向代理下的子路径（例如 https://example.com/app/my-app）时，认证中间件（如 auth 或 guest）触发的重定向（如未登录跳转 /login）常错误指向 http://localhost:8000/login，而非预期的 https://example.com/app/my-app/login。这并非缓存残留或配置遗漏的单一问题，而是 Laravel URL 生成逻辑与服务器实际请求环境脱节所致。
✅ 正确配置 APP_URL 与应用上下文
首先，确保 .env 文件中 APP_URL 设置为完整、带协议的生产地址，且必须包含子路径前缀：
APP_URL=https://example.com/app/my-app
⚠️ 注意：
- 不要省略 https://（或 http://，但生产环境强烈建议 HTTPS）；
- 必须包含 /app/my-app 子路径，Laravel 的 url()、route() 等辅助函数依赖此值构建绝对 URL；
- 修改后务必清除所有缓存：
php artisan config:clear php artisan cache:clear php artisan view:clear php artisan route:clear
✅ 配置反向代理信任（关键！）
若使用 Nginx/Apache 反向代理，Laravel 默认无法识别客户端真实协议（HTTPS）和主机头（Host），导致 url() 生成 HTTP + localhost。需显式告知 Laravel 信任代理头：
在 app/Http/Middleware/TrustProxies.php 中，设置受信任的代理 IP 和头信息：
<?php
namespace App\Http\Middleware;
use Illuminate\Http\Middleware\TrustProxies as Middleware;
use Illuminate\Http\Request;
class TrustProxies extends Middleware
{
/**
* The trusted proxies for this application.
*
* @var array<int, string>|string|null
*/
protected $proxies = '*'; // 或指定 IP 如 ['192.168.1.10']
/**
* The headers that should be used to detect proxy traffic.
*
* @var int
*/
protected $headers =
Request::HEADER_X_FORWARDED_FOR |
Request::HEADER_X_FORWARDED_HOST |
Request::HEADER_X_FORWARDED_PORT |
Request::HEADER_X_FORWARDED_PROTO |
Request::HEADER_X_FORWARDED_PREFIX;
}? 原理：X-Forwarded-* 头由反向代理注入，Laravel 通过 TrustProxies 中间件读取这些头来修正 url() 生成逻辑——例如将 X-Forwarded-Proto: https 和 X-Forwarded-Prefix: /app/my-app 合并进最终 URL。
✅ 路由层兜底：显式控制重定向路径（推荐组合方案）
尽管上述配置已能解决大部分场景，但为彻底规避 RedirectIfAuthenticated 或 Authenticate 中间件内部硬编码逻辑带来的不确定性，建议在路由层主动接管未认证用户的重定向行为：
在 routes/web.php 中，使用 Route::redirect() 显式定义根路径跳转，并确保认证路由位于子路径组内：
// routes/web.php
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Route;
// 所有路由均以 '/app/my-app' 为前缀（需在 RouteServiceProvider 中已配置）
Route::prefix('app/my-app')->group(function () {
// 未登录用户访问根路径时，跳转至子路径下的 /login
Route::middleware('guest')->group(function () {
Route::redirect('/', '/login')->name('home');
});
// 标准认证路由（自动注册 /login, /register 等）
Auth::routes([
'login' => true,
'register' => false,
'reset' => false,
'verify' => false,
]);
// 受保护的后台路由
Route::middleware('auth')->group(function () {
Route::get('/dashboard', function () {
return view('dashboard');
})->name('dashboard');
});
});✅ 此方式优势：
- 完全绕过中间件内部重定向逻辑，由路由直接控制；
- Route::redirect('/', '/login') 生成的是相对路径重定向，浏览器基于当前 URL（example.com/app/my-app/）自动补全为 example.com/app/my-app/login；
- 语义清晰，便于维护与调试。
? 验证与调试技巧
- 检查生成的 URL：在 Blade 模板或 Tinker 中执行 {{ url('/login') }}，确认输出是否为 https://example.com/app/my-app/login；
- 查看中间件源码：Illuminate\Auth\Middleware\RedirectIfAuthentication 中的 $redirectTo = '/login' 是相对路径，其最终跳转地址取决于 url() 辅助函数的输出；
- 使用 php artisan tinker 手动测试：
>>> request()->fullUrl() => "https://example.com/app/my-app/dashboard" >>> url('/login') => "https://example.com/app/my-app/login"
✅ 总结
修复 Laravel 子路径部署下认证重定向错误，需三步闭环：
- 精准配置 APP_URL（含协议与完整子路径）；
- 启用并配置 TrustProxies，让 Laravel 正确感知反向代理传递的真实请求上下文；
- 路由层显式控制重定向，用 Route::redirect() 替代隐式中间件跳转，实现可预测、易维护的行为。
切勿仅依赖 php artisan optimize:clear 或重启 php artisan serve——后者在生产环境本就不应启用。真正的解法在于对 Laravel URL 生成机制与部署拓扑的理解与协同配置。
