laravel 10→11不能仅靠composer update，因composer不识别大版本跃迁，必须同步更新所有laravel/*包约束、doctrine/dbal:^4.0等依赖，删除旧lock与vendor，并手动迁移bootstrap/app.php、appserviceprovider::register()等废弃逻辑。
跨大版本升级不能靠 composer update 一键解决，必须手动对齐约束、迁移废弃逻辑、验证运行时行为——否则启动失败、中间件静默失效、日志不输出都是常态。
为什么 composer update 升不了 Laravel 10 → 11？
Composer 的依赖求解器只看 composer.json 中的版本字符串，不会主动识别“这是大版本跃迁”。"laravel/framework": "^10.0" 永远不会升到 11.x，哪怕你执行 composer update --with-all-dependencies。
- 官方明确要求：所有
laravel/*包（如laravel/sail、laravel/pint）必须同步改约束，不能只动framework - Laravel 11 要求
doctrine/dbal:^4.0，但旧 lock 文件可能锁着 v3.x，直接 update 会卡住或报错 -
phpunit/phpunit已从 Laravel 11 的默认 require 中移除，保留它会导致冲突
升级前必须做的三件事
跳过这步，后面全是救火。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
php artisan --version确认当前框架真实版本（别信composer show laravel/framework，它可能显示缓存值） - 打开对应升级指南：https://www.php.cn/link/3ab5399acb49634fa9e34acb9c5b4b0f（把 11 换成你的目标版本）
- 删掉
composer.lock和vendor/目录——不要试图复用旧 lock 文件，v2 的 SAT 求解器对残留约束极度敏感
配置与代码迁移最容易漏的点
这些改动不会报错，但会让应用在关键路径上静默失效。
-
bootstrap/app.php在 Laravel 10+ 已移除，所有绑定逻辑要移到config/app.php或服务提供者中 -
App\Providers\AppServiceProvider::register()方法在 Laravel 11 中被彻底废弃，原内容必须挪到boot()或单独的服务容器绑定文件里 -
config/logging.php的stack驱动默认不再包含stderr，本地开发看不到日志？就卡在这儿 -
routes/web.php：Laravel 11 默认自动包裹Route::middleware('web')，若你之前手动加过，中间件会被执行两次
升级后第一轮验证该盯什么
别急着跑测试套件，先确认基础链路没断。
- 执行
php artisan serve，看是否能启动；启动失败 90% 是引导文件或服务提供者问题 - 访问任意路由，检查响应头是否有
X-RateLimit-Remaining（验证中间件链） - 触发一个写日志的操作（如
Log::info('test')），去 storage/logs/laravel.log 确认内容是否写入（验证 logging 配置） - 执行
php artisan tinker，输入app()看是否返回容器实例（验证服务容器是否正常初始化）
真正难的不是改代码，是判断哪些改动属于“框架强制迁移”，哪些属于“你项目里自己埋的兼容性债”。比如 AppServiceProvider::register() 被删，是 Laravel 的事；但如果你在 register() 里绑了一个自定义 Redis 连接池，那这个逻辑就得你亲手重写——没人替你兜底。
