Laravel仅在Ubuntu环境下认证路由异常问题排查与解决

问题背景 #

我在Windows和Ubuntu环境分别部署了Laravel 9.42项目：

• Windows使用XAMPP（PHP 8.2.1），认证功能正常，正确输入用户名和密码后会跳转至dashboard页面；
• Ubuntu环境使用PHP 8.1.7（未使用XAMPP），认证功能失效，输入正确的用户名和密码后会被导向名为login的home路由页面。

相关代码 #

LoginController.php

class LoginController extends Controller
{
    public function index(){
        return view('login');
    }

    public function authenticate(Request $request)
    {
        $credentials = $request->validate([
            'username' => 'required',
            'password' => 'required',
        ]);
 
        
        if (Auth::attempt($credentials)) {
            $request->session()->regenerate();
            return redirect()->intended('/dashboard');
        }
 
        return back()->withErrors([
            'username' => 'The provided credentials do not match our records.',
            'password' => 'The provided credentials do not match our records.',
        ]);
    }

}

web.php

Route::get('/home', function () {
    return view('home');
})->name('login');

Route::get('/login', [LoginController::class, 'index'])->middleware('guest');
Route::post('/login', [LoginController::class, 'authenticate']);

Route::get('/dashboard', [DashboardController::class, 'index'])->name('dashboard')->middleware('auth');

排查与修复步骤 #

1. 修复Session目录权限 #

Laravel认证依赖Session存储，Ubuntu环境下常因目录权限不足导致Session无法写入：

• 执行命令修改权限：

  chmod -R 755 storage/framework/sessions
  chown -R www-data:www-data storage/framework/sessions
  

• 确认.env中Session驱动配置为file（避免其他驱动的额外配置问题）：

  SESSION_DRIVER=file
  

2. 修正路由命名逻辑 #

当前路由中/home被标记为login命名路由，这会干扰redirect()->intended()的跳转逻辑——当没有预定义的跳转目标时，Laravel会默认跳转到login命名路由，而非指定的/dashboard。

• 修改web.php，将login命名路由绑定到实际的登录页面：

  Route::get('/home', function () {
      return view('home');
  });
  
  Route::get('/login', [LoginController::class, 'index'])->middleware('guest')->name('login');
  Route::post('/login', [LoginController::class, 'authenticate']);
  
  Route::get('/dashboard', [DashboardController::class, 'index'])->name('dashboard')->middleware('auth');
  

3. 验证密码哈希有效性 #

确保Ubuntu环境中用户密码的哈希值与Windows环境一致：

• 进入Laravel Tinker验证密码：

  php artisan tinker
  

  执行验证代码（替换为实际的用户密码和数据库中的哈希值）：

  Hash::check('用户输入的密码', '数据库中存储的password字段值');
  

  如果返回false，说明密码存储异常，需重置用户密码（通过Hash::make('新密码')生成正确哈希后更新数据库）。

4. 检查并安装必要PHP扩展 #

Ubuntu默认PHP配置可能缺少Laravel依赖的扩展：

• 安装所需扩展：

  sudo apt install php8.1-mbstring php8.1-xml php8.1-bcmath php8.1-json php8.1-session
  

• 重启Web服务器：

  # Nginx
  sudo systemctl restart nginx
  # Apache
  sudo systemctl restart apache2
  

5. 清除Laravel缓存 #

环境差异可能导致缓存配置冲突，执行以下命令清除所有缓存：

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

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