composer update laravel/framework 不会升级所有依赖，但会按版本约束重算整个依赖图，可能连带升级 symfony/* 等底层组件，导致兼容性问题。
composer update laravel/framework 会连带升级所有依赖？
不会自动升级全部依赖，但默认行为比你想的更激进：composer update laravel/framework 会按 composer.json 中该包的版本约束（如 "^10.0"），重新计算整个依赖图，可能顺带升级 symfony/*、doctrine/dbal 等底层组件——哪怕你没显式写它们。
常见错误现象：运行后 php artisan tinker 报错 Class "SymfonyComponentConsoleCommand" not found，其实是 symfony/console 被升到 v7，而当前 Laravel 10 并不兼容。
- 只更新框架本身：用
composer update laravel/framework --with-dependencies，但仅限明确知道哪些子依赖必须同步时才加--with-dependencies - 更安全的做法是锁死关键底层包：在
composer.json的require里补上"symfony/console": "^6.2"这类约束（对应 Laravel 10 兼容范围） - 别信
"laravel/framework": "^10.0"就万事大吉——它不阻止 Composer 拉取不兼容的symfony小版本
扩展包（如 laravel-lang、spatie/laravel-permission）突然报错怎么办？
不是框架升级失败，而是扩展包没适配新 Laravel 版本的接口变更。比如 Laravel 10 移除了 IlluminateSupportStr::slug() 的第三个参数，而老版 laravel-lang 还在用。
使用场景：你刚跑完 composer update，php artisan config:clear 就抛出 Call to undefined method IlluminateSupportStr::slug()。
- 先查扩展包的 GitHub Releases 页面，看最新 tag 是否标注支持 Laravel 10/11
- 检查其
composer.json里的"require": {"laravel/framework": "^9.0"}—— 如果还是 9.x，就别硬升 - 临时降级：用
composer require spatie/laravel-permission:"^5.5"（Laravel 10 兼容版），而不是留空让 Composer 自选 - 别删
vendor重装——这会绕过 Composer 的版本兼容性校验，问题更隐蔽
为什么 vendor/autoload.php 加载失败或找不到类？
根本原因常是 Composer 自动优化了 autoloader，但没识别出你手动添加的扩展目录（比如 packages/mycompany/core），或者升级后 PSR-4 映射路径变了。
性能影响：composer dump-autoload -o 生成的优化文件会跳过未声明的命名空间，导致 Class "MyCompanyCoreFoo" not found。
- 确认自定义路径是否在
composer.json的"autoload": {"psr-4": {...}}里正确声明 - 升级后立刻运行
composer dump-autoload（不加-o），排除优化干扰 - 如果用了
classmap，检查对应目录下是否有.php文件被 Git 忽略或未提交 - Laravel 10 开始默认启用
optimize-autoloader，CI 环境若没跑composer install --no-dev，可能漏掉开发专用的 autoload 规则
版本约束写成 ^9.0 还是 9.*？哪个更稳？
^9.0 更符合语义化版本规范，也更安全；9.* 表面宽松，实则危险——它允许升到 9.99.99，而 Laravel 的小版本可能含破坏性变更（比如 9.50 改了 Queue 接口）。
兼容性影响：Laravel 官方只保证同一主版本内「点号升级」（如 10.0 → 10.42）向后兼容，不承诺 9.* 范围内所有组合都可用。
- 生产环境强制用
^10.0（或更细粒度如^10.25），避免意外跨主版本 - 测试环境可试
10.*，但每次composer update后必须跑完整测试套件 - 别在
require-dev里写"laravel/framework": "dev-main"—— 这会拉取未发布的代码，和稳定分支行为不一致
最易被忽略的一点：Composer 的 platform 配置（如 "php": "8.1"）若和实际环境不符，会导致它选择错误的依赖版本——比如服务器是 PHP 8.1，但 composer.json 写了 "php": "8.0"，就可能装上不兼容的 ramsey/uuid v3。