Composer update卡在依赖冲突是因为Laravel核心包与第三方包对同一依赖（如symfony/console）提出互斥版本约束，导致无法找到满足所有条件的解；常见报错为“Conclusion: don't install...”及长链条“because X requires Y, but Z requires not-Y”。
为什么composer update总卡在依赖冲突？
因为 Laravel 的核心包（如 laravel/framework）和其他第三方包（如 spatie/laravel-permission）对同一依赖（比如 symfony/console）提出了互斥的版本约束，Composer 无法找到满足所有条件的解。它不是“不更新”，而是“找不到合法组合”。
常见现象：composer update 报错类似 Conclusion: don't install laravel/framework v10.48.0，后面跟着一长串“because X requires Y, but Z requires not-Y”链条。
- 别直接删
vendor/或composer.lock—— 这只会让问题更难回溯 - 优先用
composer why-not vendor/package:version定位哪个包在阻止安装（例如composer why-not spatie/laravel-permission:^6.0） - 检查你本地
composer.json中是否手动锁死了某个底层依赖（如"symfony/http-foundation": "6.2.*"），这常是隐形冲突源
如何安全升级 Laravel 主版本（如 v9 → v10）？
Laravel 主版本升级不是单纯改 "laravel/framework": "^10.0" 就能完成的。v10 要求 PHP ≥ 8.1、doctrine/dbal ≥ 3.5，且大量生态包尚未适配 —— 直接 update 必然失败。
- 先运行
composer require laravel/framework:^10.0 --dry-run，看哪些包被标记为“will be removed”或“will be downgraded” - 逐个查关键依赖的兼容性：访问对应包的 GitHub README 或
composer show vendor/package看其require字段是否支持 Laravel 10 - 对暂不兼容的包（如旧版
barryvdh/laravel-debugbar），临时降级 Laravel 到 v9.52 + 升级该包到 v4.x，再统一升；不要硬等“全兼容”
composer require 新包时提示“conflict with laravel/framework”怎么办？
这不是新包有问题，而是它声明的最低 Laravel 版本高于你当前项目所用版本。例如装 laravel/sanctum:^4.0 会要求 laravel/framework:^10.0，而你项目还是 v9。
- 先确认需求：是否真需要最新版？
sanctum:^3.2对 Laravel 9 完全兼容，功能差异极小 - 若必须用新版，改
composer.json中laravel/framework版本后，**只运行composer update laravel/framework**，避免连带更新其他包引发新冲突 - 某些包（如
orchestra/testbench）专为测试设计，其版本号与 Laravel 主版本强绑定，务必按文档选对应 tag（orchestra/testbench:^8.0对应 Laravel 9）
什么时候该删 composer.lock？
仅当明确知道 lock 文件已损坏（例如 git 合并冲突残留
- 删之前先
git status确认没未提交修改，否则可能丢掉本地 patch - 删完必须立刻
composer install（不是update），否则vendor/和 lock 不一致，CI 构建会失败 - 团队协作时，
composer.lock是契约 —— 它比composer.json更权威。有人提 PR 改了 lock 却没改 json，那大概率是误操作
最麻烦的往往不是冲突本身，而是不同开发者本地用了不同版本的 Composer（2.2 vs 2.5），导致解析依赖图逻辑微差。统一用 composer self-update --2 锁死大版本，比调半天配置更省时间。
