Laravel Jetstream项目突现Inertia\Ssr\Gateway不存在错误求助

数据老陈

2026-8-24

解决Laravel Jetstream + Inertia项目中Target class [Inertia\Ssr\Gateway]不存在的问题

检查Inertia配置文件
打开config/inertia.php，确认SSR处于禁用状态：
```
'ssr' => [
    'enabled' => false,
],
```
如果没有该配置文件，执行以下命令发布配置：
```
php artisan vendor:publish --provider="Inertia\ServiceProvider"
```
之后再修改上述配置项。
清理Laravel缓存
执行一系列缓存清理命令，确保容器和配置缓存被彻底清除：
```
php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear
```
重新安装Composer依赖
删除项目根目录下的vendor文件夹和composer.lock文件，然后执行：
```
composer install
```
若出现版本冲突，检查composer.json中inertiajs/inertia-laravel的版本，Jetstream v2建议使用兼容版本（如^0.6.0），调整后重新执行安装命令。
检查前端配置并重新编译资源
查看resources/js/app.js或resources/js/bootstrap.js，确保没有导入或初始化Inertia SSR的代码（如import { createServer } from '@inertiajs/server'）。
然后重新安装前端依赖并编译：
```
npm install
npm run build
```
检查环境变量
打开.env文件，确认没有设置INERTIA_SSR_ENABLED=true，若有则改为false或删除该行。
重启服务
重启你的Web服务器（如Nginx、Apache）或PHP-FPM进程，确保所有配置变更生效。