500错误是PHP或Web服务器运行时崩溃返回的状态码，需查日志定位PHP Fatal Error；检查autoload是否生效、依赖版本兼容性、文件权限、PHP版本及扩展是否匹配。
500 错误不是 Composer 报的，是 PHP 或 Web 服务器在运行时崩溃后返回的状态码；Composer 只负责把代码放进 vendor，它不执行、不校验逻辑兼容性。真正要查的，是装包后哪段代码挂了、为什么挂。
看日志：先确认是不是 PHP Fatal Error
500 出现时，第一反应不是重装包，而是翻日志。Nginx 的 /var/log/nginx/error.log 或 Apache 的 /var/log/apache2/error.log 里通常有明确线索，比如：
-
PHP Fatal error: Uncaught Error: Class "Think\View" not found→ 视图类没加载，可能是think-view没注册服务提供者，或 autoload 失效 -
PHP Fatal error: Call to undefined method Illuminate\Support\Facades\DB::connection()→ Laravel 版本和laravel/framework实际安装版本不匹配，常见于手动改过composer.json但没跑composer update -
PHP Warning: require(/path/to/vendor/autoload.php): failed to open stream→vendor目录权限不对，或autoload.php被删/损坏
验证 autoload 是否生效：别信缓存，重生成再试
Composer 安装完包，不一定就自动可用了——尤其是你改过 composer.json 的 autoload 段，或用了 path 类型仓库。直接跑：
composer dump-autoload -o
然后检查 vendor/composer/autoload_classmap.php 里有没有你调用的类名。没有？说明这个类根本没被纳入自动加载规则，要么包没装对，要么它的 composer.json 里 autoload 配置写错了（比如漏了 psr-4 映射）。
顺手再跑一句：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
composer show topthink/think-view
确认实际装的是哪个版本，别只盯着 composer.json 里写的 "topthink/think-view": "^2.0" —— 它可能因为依赖冲突，最终装了 1.9.9 这种不兼容版。
查依赖树：谁偷偷升级了关键组件
比如升级 maatwebsite/excel 后报 500，但错误堆栈指向 phpoffice/phpspreadsheet 的某个方法不存在。这时候得查清楚：
-
composer show --tree maatwebsite/excel看它拉了哪个版本的phpspreadsheet -
composer depends phpspreadsheet看还有没有别的包也在拉它（比如测试工具、监控 SDK），它们可能带入更高主版本，导致冲突 - 对比升级前后
composer.lock，搜索phpspreadsheet对应的version和source.reference，如果 commit hash 变了，代码确实不同了
临时加一行 var_dump(class_exists('PhpOffice\PhpSpreadsheet\Spreadsheet')); 放到出错前，能快速区分是“类找不到”还是“类存在但方法没了”。
权限与环境：最容易被跳过的两个硬条件
Linux 下装完包却 500，尤其在部署后首次访问，大概率是权限或平台要求没满足：
-
bootstrap/cache和storage目录必须可写，Web 用户（如www-data）要有权限。常见操作：chmod -R 755 bootstrap/cache storage，chown -R www-data:www-data bootstrap/cache storage - PHP 版本不匹配：比如 Laravel 8.74 要求 PHP >=8.0.2，但服务器是 7.4，
composer install --ignore-platform-reqs能过安装，但运行时直接Fatal error: Uncaught TypeError→ 最终 500 - 扩展缺失：装了
ext-redis依赖的包，但 PHP 没开 redis 扩展，报错可能藏在日志里，表现为 “Class 'Redis' not found” 或连接失败后静默崩溃
真正难搞的，往往不是某条命令没敲对，而是多个条件同时松动：autoload 没刷新 + 权限没给足 + PHP 版本卡在临界点。查的时候别单线程推进，日志、权限、版本、扩展，四点并行核对才省时间。
