Laravel迁移至VPS后AJAX请求偶发500错误求助

开发者阿泽

2026-5-14

解决Laravel AJAX请求偶尔返回500（Undefined variable: $errors）的问题

这种问题我之前排查过好几次，咱们从核心原因入手一步步解决：

检查ShareErrorsFromSession中间件是否生效
Laravel视图里的$errors变量是由Illuminate\View\Middleware\ShareErrorsFromSession这个中间件自动注入的，它会把session中的错误信息共享到所有视图。你需要确认这个中间件是否在你的请求流程里：
打开app/Http/Kernel.php，找到web中间件组，看看里面是否包含这个中间件。正常情况下Laravel默认是包含的，但如果你的AJAX请求走的是api中间件组（比如路由定义在api.php里），那api组默认是没有这个中间件的，而且api组默认不启用session，自然也无法获取到错误信息。
确认AJAX路由的归属
看看触发错误的AJAX请求对应的路由是写在web.php还是api.php里：
- 如果是api.php：api中间件组是为无状态接口设计的，没有session和错误共享的逻辑。要么把AJAX路由移到web.php（推荐，因为需要视图渲染的请求本来就属于web范畴），要么手动给该路由添加web中间件（比如Route::post('/ajax-action', [Controller::class, 'action'])->middleware('web');）。
排查视图渲染的场景
有时候AJAX请求本来应该返回JSON，但后端代码不小心返回了完整视图（包含layout），而这个请求又没经过web中间件，就会触发$errors未定义的错误。检查你的AJAX接口代码，确保只有需要渲染页面的请求才调用view()，AJAX请求应该返回response()->json()。

临时容错方案（治标）
如果暂时没法调整路由和中间件，可以直接在视图里给$errors加默认值，避免报错：

@if (count($errors ?? []) > 0)
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

不过这只是临时解决，还是建议从中间件和路由层面彻底修复。

session配置排查
虽然你说PHP版本一致，但VPS上的session驱动配置可能有问题（比如文件驱动的存储目录没有写入权限）。如果session无法正常存储，ShareErrorsFromSession也没法正常工作，但这种情况通常是持续报错而非偶尔出现，不过也可以检查下config/session.php里的配置是否正确。

为什么会“有时正常有时报错”？大概率是部分AJAX请求经过了web中间件（能获取到$errors），另一部分没有经过（触发错误），你可以对比下正常和报错的请求路由、中间件差异。

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