composer install成功后运行期报错（如class not found、call to undefined method等）主因是多版本冲突、php/扩展不匹配或require-dev包误入autoload，需检查autoload映射、php环境、全局与本地依赖共存问题。
运行期错误不是 Composer 安装阶段报错的翻版，它往往出现在 composer install 成功、vendor/autoload.php 也能加载之后——比如 Class not found、Call to undefined method、Cannot redeclare，甚至 PHP 解析失败（ParseError: syntax error, unexpected 'match'）。根源常是 Composer 解析出的版本组合在语义上“合法”，但实际运行时因类加载顺序、扩展冲突或 PHP 版本越界而崩。
为什么 install 成功了，运行却报 Class not found？
这不是自动加载路径错了，而是多个包提供了同名类，或同一包被加载了两个不兼容版本。常见于全局与本地共存、或 require-dev 包意外进入生产 autoload。
- 检查
vendor/composer/autoload_classmap.php和autoload_psr4.php，确认目标类是否真被注册；若没出现，说明该类所在包根本没进 autoload 范围（可能被conflict规则排除） - 运行
composer show --tree | grep -A5 "your-package"，看它是被require还是require-dev拉入；require-dev的包默认不参与autoload，除非你手动加了"autoload-dev"配置 - 用
php -d display_errors=1 -d error_reporting=-1 -r "require 'vendor/autoload.php'; var_dump(class_exists('Your\Class'));"直接验证——绕过框架缓存，看清真实加载状态
ParseError 或 Fatal error: Uncaught Error: Call to undefined method
这类错误往往指向 PHP 版本或扩展不匹配：Composer 允许安装一个“语法上合法”的包，但它用了你当前 PHP 不支持的特性（如 match 表达式要求 PHP 8.0+），或调用了未启用的扩展（如 intl、mbstring）。
- 别只信
phpinfo()页面——运行php -v和php -m | grep -E "intl|mbstring|json|curl|openssl"确认 CLI 环境真实可用 - 查出问题类所在的包，再执行
composer show vendor/package，看它的require字段里有没有"php": "^8.1"这类约束；如果本地是 PHP 7.4，它本不该被装进来——说明你用了--ignore-platform-reqs或config platform.php强行绕过，这会埋下运行期雷 - 临时降级该包到兼容版本：
composer require vendor/package:2.9.1 --no-update，再composer update vendor/package --with-dependencies，避免连带升级其他高风险依赖
Cannot redeclare function / Cannot declare class
典型症状是某个函数或类被定义两次，最常见原因是全局安装的工具（如 php-cs-fixer、phpunit）和项目本地依赖了同一包的不同版本，且都注册了 autoload。
- 运行
composer global show，列出所有全局包；重点排查是否和项目composer.json里的require或require-dev重名 - 临时禁用全局 autoload：重命名
~/.composer/vendor（Linux/macOS）或%USERPROFILE%AppDataRoamingComposer endor（Windows），再跑一次应用，看错误是否消失 - 错误堆栈里如果出现路径含
/home/xxx/.composer/vendor/或C:UsersxxxAppDataRoamingComposer endor，就是它了——直接composer global remove vendor/package，改用项目本地安装 +./vendor/bin/xxx调用
真正棘手的运行期冲突，往往藏在 autoload 之后、第一次调用之前——比如某个包的 post-install-cmd 脚本修改了配置，或它的服务提供者在 Laravel 启动时做了不可逆的扩展注册。这种时候，composer install --profile 和 strace -e trace=openat,stat php -r "require 'vendor/autoload.php';" 比任何文档都管用。
