composer update 不会自动升级 laravel 主版本，必须先修改 composer.json 中 "laravel/framework" 的版本约束（如 "^10.0" 改为 "^11.0"），并确保 php ≥ 8.2、执行 composer update laravel/framework --with-all-dependencies，同时手动适配配置、废弃 api 及第三方包兼容性。
composer update 不会自动升级 Laravel 主版本
直接运行 composer update 永远不会把 laravel/framework 从 "^10.0" 升到 "^11.0" —— 它只在 composer.json 当前约束范围内更新补丁/小版本。你看到“没变化”，大概率是因为版本号根本没改。
实操建议：
- 先查当前框架版本：
php artisan --version - 打开
composer.json，定位"laravel/framework"行，把值改成目标主版本的语义化范围（如升 11："^11.0"） - 别写死具体小版本（如
"11.2.0"），否则后续composer update无法拉新补丁 - 同时检查
"php"行是否满足要求（Laravel 11 需"^8.2"），否则 Composer 会静默跳过
必须加 --with-all-dependencies 才能真正生效
只跑 composer update laravel/framework 是危险操作：Laravel 主包升级后，symfony/http-foundation、doctrine/dbal、nesbot/carbon 这些隐式依赖很可能卡在旧版，导致启动时报 Class not found 或方法不存在。
正确做法是强制 Composer 重解整个依赖树：
- 先备份
composer.lock（重命名为composer.lock.bak） - 执行：
composer update laravel/framework --with-all-dependencies - 如果中途报
doctrine/dbal冲突，单独先装：composer require doctrine/dbal:^4.0，再重试 - 若失败反复出现，删掉
vendor/和composer.lock，从头来
升级后不能直接跑 migrate:fresh
php artisan migrate:fresh 是清库重迁命令，不是升级流程的一部分。生产环境误用等于删库跑路 —— 官方升级指南里从不默认推荐它。
真正该做的：
- 先运行
php artisan config:clear、php artisan cache:clear、php artisan view:clear - 检查
routes/web.php：Laravel 11 默认自动包裹Route::middleware('web')，若你之前手动写了这层，中间件会被应用两次 - 确认
app/Providers/AppServiceProvider.php中已移除空的register()方法（Laravel 11 已废弃该方法骨架） - 验证日志配置：
config/logging.php的stack驱动默认不再包含stderr，本地调试可能突然看不到错误输出
第三方包兼容性必须手动核对
Laravel 升级不等于生态包自动适配。像 laravel/sanctum、spatie/laravel-ignition、nunomaduro/collision 都有严格匹配的版本要求（例如 Laravel 11 对应 sanctum:^4.0、ignition:^2.4）。
容易被忽略的点：
-
phpunit/phpunit在 Laravel 11 中已被弃用，需换成"phpunit/phpunit": "^11.0"或改用 Pest - 某些包（如
barryvdh/laravel-debugbar）可能尚未适配 Laravel 11，得查 GitHub issues 确认状态 - 自定义 Artisan 命令若用了废弃的 Facade（如
App、DB的旧别名），运行时才会暴露，必须全量测试 - 升级后首次运行
php artisan test前，先确保phpunit.xml中的bootstrap路径指向正确的vendor/autoload.php
最复杂的部分往往不在命令本身，而在配置合并与废弃 API 的识别 —— 比如 bootstrap/app.php 在 Laravel 10 就已移除，但很多项目还留着旧引导逻辑；又比如 Kernel 类结构变化，不对比官方 laravel/laravel 对应 tag 的 app/Http/Kernel.php，很容易漏掉中间件注册方式变更。
