yii3项目部署时class/method not found多因vendor中同一包存在多版本冲突，需四步解决：一用composer show -s查依赖树定位冲突包；二在composer.json加conflict字段锁定关键包版本；三通过replace或require覆盖上游包的不良依赖；四清理vendor与lock后用composer install --no-dev --optimize-autoloader重装并验证。
Yii3项目部署时因composer install失败或运行时报Class not found/Method not found，多数由vendor目录中同一包存在多个版本引发——比如symfony/console被yii-base和phpunit分别引入v5.4与v6.3，导致类加载混乱。
第一步：确认冲突来源
在项目根目录执行：composer show -s，查看当前已解析的依赖树结构。该命令比composer depends更直观，能直接暴露哪些包被多次引入且版本不一致。
重点观察输出中重复出现的包名（如psr/log、symfony/polyfill-php81），并记录其不同版本号及上游依赖路径。若某包显示多个版本但只列出一个生效版本，说明Composer已按“最近声明优先”规则自动裁剪，此时冲突尚未爆发；若命令报错require does not match constraints，则冲突已阻断安装流程，必须干预。
第二步：用conflict字段锁定关键包
打开composer.json，在"require"同级添加"conflict"区块：
"conflict": {<br> "symfony/console": " "psr/log": ">=3.0.0"<br>}
这一步强制Composer拒绝安装违反约束的版本，避免后续运行时因低版本缺失方法而崩溃。注意：仅对明确知道兼容边界的核心包使用此法，比如Yii3官方文档注明需symfony/console:^5.4，就不可放任v6.x混入。
【不要在conflict中写通配符如"*"或">=0.0.0"】，否则会触发Composer校验失败，连基础安装都无法进行。
第三步：分层排除间接依赖
找到引发冲突的上游包（例如mycompany/sdk），在其composer.json中定位到引入问题包的require行，然后回到你的项目composer.json，对这个上游包添加replace或provide声明：
"replace": {<br> "symfony/console": "self.version"<br>}
或者更精准地用require覆盖：
"require": {<br> "symfony/console": "^5.4"<br>}
二者选其一即可。前者适用于你完全接管该包功能的场景，后者更稳妥——它让Composer把symfony/console当作项目顶层依赖处理，绕过上游包的旧版本声明。
这一步操作后，执行composer update symfony/console --with-dependencies，只刷新该包及其直系依赖，避免全量重装引发新冲突。
第四步：清理并验证
删除vendor目录和composer.lock文件，执行composer install --no-dev --optimize-autoloader。
加--no-dev可跳过phpunit等开发依赖的解析，大幅降低冲突概率；--optimize-autoloader会生成classmap，绕过PSR-4动态查找，使版本冲突在启动阶段即暴露，而非运行中随机报错。
最后运行php yii test（或你项目的实际入口脚本），确认无ClassNotFoundException或BadMethodCallException抛出。
