Laravel 11集成subfission/cas后session表user_id为空的问题

问题根源 #

你遇到的session表user_id为空的核心原因是：Laravel默认的DatabaseSessionHandler类通过userId()方法获取当前认证用户ID，而该方法依赖于默认的Auth Guard配置。你使用了自定义的staff表，但未正确配置Auth Guard关联到Staff模型，或者CAS登录后未通过Laravel的Auth系统完成用户认证，导致userId()返回null，最终user_id字段无法填充。

当前修改的不合理性 #

直接修改框架核心文件Illuminate\Session\DatabaseSessionHandler是不推荐的，原因如下：

• 框架版本更新时，你的自定义代码会被覆盖，导致功能失效；
• 硬编码修改核心逻辑违反了Laravel的扩展设计原则，项目维护性变差；
• 无法在团队协作中统一同步该修改，容易引发环境不一致问题。

规范解决方案 #

方案1：正确配置Auth Guard并使用Laravel Auth完成登录 #

这是最符合Laravel设计的方案，优先推荐：

1. 修改config/auth.php，将默认Guard和Provider关联到Staff模型：

return [
    'defaults' => [
        'guard' => 'web',
        // 如果需要默认使用staff guard，可改为'staff'
    ],

    'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'staffs',
        ],
        // 也可单独创建staff guard
        'staff' => [
            'driver' => 'session',
            'provider' => 'staffs',
        ],
    ],

    'providers' => [
        'staffs' => [
            'driver' => 'eloquent',
            'model' => App\Models\Staff::class,
        ],
    ],
];

2. 在CAS登录回调逻辑中，使用Laravel的Auth系统完成Staff用户的登录：

// 示例：CAS登录成功后的回调处理
$casUserId = cas()->user();
$staff = \App\Models\Staff::where('cas_id', $casUserId)->firstOrFail();

// 使用默认Guard登录
\Illuminate\Support\Facades\Auth::login($staff);
// 或者指定staff guard登录
// \Illuminate\Support\Facades\Auth::guard('staff')->login($staff);

完成上述配置后，Laravel默认的addUserInformation方法会自动通过userId()获取当前登录Staff的ID，填充到session表的user_id字段，无需修改任何核心文件。

方案2：通过依赖注入扩展Session Handler（若无法使用Auth登录） #

如果因CAS包限制无法通过Laravel Auth系统完成登录，可通过扩展DatabaseSessionHandler类实现自定义逻辑，且不修改核心文件：

1. 创建自定义Session Handler类：

namespace App\Session;

use Illuminate\Session\DatabaseSessionHandler;
use App\Models\Staff;

class CustomDatabaseSessionHandler extends DatabaseSessionHandler
{
    protected function addUserInformation(&$payload)
    {
        parent::addUserInformation($payload);
        
        // 如果默认userId()未获取到ID，补充CAS关联的Staff ID
        if (empty($payload['user_id']) && function_exists('cas')) {
            $staff = Staff::where('cas_id', cas()->user())->first();
            if ($staff) {
                $payload['user_id'] = $staff->id;
            }
        }

        return $this;
    }
}

2. 在App\Providers\AppServiceProvider的register方法中，替换默认的Session Handler：

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use App\Session\CustomDatabaseSessionHandler;
use Illuminate\Session\DatabaseSessionHandler;

class AppServiceProvider extends ServiceProvider
{
    public function register()
    {
        // 绑定自定义Session Handler替换默认实现
        $this->app->bind(DatabaseSessionHandler::class, CustomDatabaseSessionHandler::class);
    }
}

这种方式通过Laravel的依赖注入机制扩展核心类，既保留了框架原有逻辑，又加入了自定义处理，且不会被框架更新覆盖。

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