Laravel URL含有效文件扩展名时丢失会话问题求助

1. 检查生产环境Web服务器配置 #

生产环境的Apache/Nginx可能会误将带有效文件扩展名的请求（即使扩展名出现在query string中）判定为静态文件，跳过Laravel入口文件index.php，导致租户会话未初始化，触发登出重定向。

Apache配置调整 #

确保.htaccess规则强制所有请求经过index.php，覆盖query string带扩展名的场景：

RewriteEngine On

# 基础规则：非目录/文件的请求都走index.php
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

# 额外处理query string含常见文件扩展名的情况
RewriteCond %{QUERY_STRING} \.(png|jpg|jpeg|gif|css|js)$ [NC]
RewriteRule ^ index.php [L]

Nginx配置调整 #

修改站点配置，避免优先匹配静态文件规则拦截带扩展名参数的请求：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

# 对带query string的静态文件请求，强制转发到Laravel处理
location ~* \.(png|jpg|jpeg|gif|css|js)$ {
    if ($query_string) {
        rewrite ^ /index.php?$query_string last;
    }
    try_files $uri =404;
}

2. 调整Tenancy中间件与会话逻辑 #

Tenancy的会话隔离机制可能在请求被误判为静态文件时，未能正确加载租户会话，导致当前会话失效。

• 检查config/tenancy.php的中间件顺序，保证租户识别完成后再初始化会话：

'middleware' => [
    'universal' => [
        // 租户识别中间件（如InitializeTenancyByDomain）
        Stancl\Tenancy\Middleware\InitializeTenancyByDomain::class,
        // 会话初始化中间件放在租户识别之后
        Illuminate\Session\Middleware\StartSession::class,
        // 其他中间件...
    ],
],

• 添加自定义中间件，强制对带有效扩展名参数的请求初始化租户会话：

<?php

namespace App\Http\Middleware;

use Closure;
use Stancl\Tenancy\Tenancy;

class ForceTenancyForFileRequests
{
    public function handle($request, Closure $next)
    {
        // 匹配常见有效文件扩展名
        if (preg_match('/\.(png|jpg|jpeg|gif|css|js)$/i', $request->getQueryString())) {
            // 根据你的租户识别逻辑初始化（示例为通过请求对象获取租户）
            if ($request->tenant) {
                app(Tenancy::class)->initialize($request->tenant);
            }
        }

        return $next($request);
    }
}

将此中间件添加到app/Http/Kernel.php的web中间件组，放在Tenancy核心中间件之后。

3. 查看生产环境日志定位精准问题 #

检查storage/logs/laravel.log，查找请求被拦截时的具体异常信息（如会话未找到、租户未识别、CSRF验证失败等），这能快速定位问题根源。

4. 排除Laravel静态文件路由干扰 #

在routes/web.php中添加兜底路由，确保所有请求都进入Laravel路由处理流程：

Route::any('{any}', function () {
    // 转发到对应控制器或返回404
    abort(404);
})->where('any', '.*');

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