laravel 11 是框架逻辑重写，非简单升级：移除 app/http/kernel.php 和 app/providers 目录，合并路由为 routes.php，bootstrap/app.php 成为主干入口，所有中间件、服务提供者、异常处理器均需显式注册，容错率低但可控性高。
直接说结论：Laravel 11 不是“升级版 Laravel 10”，它是框架逻辑的重写——没有 app/Http/Kernel.php，没有 app/Providers 目录，默认不加载任何服务提供者，routes/web.php 和 routes/api.php 合并为单文件 routes.php。你不能照搬旧项目结构跑起来，必须按新约定重写入口和路由组织方式。
composer create-project 装不出 Laravel 11？检查三件事
默认命令 composer create-project laravel/laravel 极大概率拉到 v10.48 或更早版本，因为 Packagist 的 latest 标签未同步。必须显式指定版本约束：
- 用
composer create-project laravel/laravel:^11.0（注意^，允许小版本更新） - 确认 Composer 是 3.x：
composer --version输出应为3.x；Composer 2.x 会卡在依赖解析 - 加
--no-interaction参数，否则初始化脚本可能跳过.env写入或 APP_KEY 生成
装完立刻进目录执行 php artisan key:generate——Laravel 11 不再自动做这件事，APP_KEY 为空会导致 session、加密、签名 URL 全部失效。
bootstrap/app.php 是新内核，不是“启动脚本”
这个文件现在承担了旧版 app/Http/Kernel.php + config/app.php + app/Providers 的职责。常见错误是只改路由、不动这里，结果报 Middleware group [api] does not exist：
- 中间件组必须显式注册：
$app->withMiddleware(function (Middleware $middleware) { $middleware->group('api', [...]); }); - AppServiceProvider 不再自动 boot，得手动
$app->register(AppServiceProvider::class) - 自定义异常处理器（如
App\Exceptions\Handler）要靠$app->withExceptions()挂载，漏掉就退回到默认错误页
别把它当“可选配置”跳过——它现在就是应用的主干逻辑定义点。
routes.php 里写 API 路由，middleware 必须显式声明
旧习惯用 Route::prefix('api')->middleware('api') 自动包裹？Laravel 11 不再支持这种隐式绑定。所有 API 路由必须逐条或分组显式挂 ->middleware('api')：
Route::middleware('api')->group(function () {
Route::get('/users', [UserController::class, 'index']);
Route::post('/users', [UserController::class, 'store']);
});
资源路由也一样：Route::apiResource('posts', PostController::class)->middleware('api')。不加这句，请求会走 web 中间件栈，CSRF 验证失败、session 无法写入、request()->user() 返回 null。
迁移文件里 default(now()) 在 MySQL 5.6 下直接报错
新生成的迁移默认给 created_at 和 updated_at 加了 ->default(now())，看着省事，但实际踩坑密集：
- MySQL 5.6 及以下不支持函数作为列默认值，报错
Invalid default value for 'created_at' - PostgreSQL 要用
->useCurrent()或->default(DB::raw('CURRENT_TIMESTAMP'))，now()会被转成字符串字面量 - 已有表数据不受影响，该字段对存量行仍是 NULL；想补全历史记录，得手写
DB::table()->update(['created_at' => now()])
最稳妥的做法：新建迁移时删掉 ->default(now())，改用 ->useCurrent()（兼容 MySQL 5.7+ 和 PostgreSQL），并在 up() 方法里单独处理存量数据。
真正卡住人的从来不是功能多寡，而是那些被“简化”掉的隐式约定——比如 bootstrap/app.php 里漏掉一行 $app->withExceptions()，整个异常处理就失效；比如 routes.php 里少写一个 ->middleware('api')，前端拿不到用户信息还查不出原因。Laravel 11 把“默认行为”砍掉了大半，剩下全是显式声明，容错率低，但可控性高。动手前，先盯紧这三个文件：bootstrap/app.php、routes.php、database/migrations。
