Composer require 安装 Yii2 扩展报“could not find package”主因是包名错误、版本不兼容或未在项目根目录执行；Class not found 则多因自动加载未更新或配置缺失，需检查目录、注册组件、刷新 autoload 并确认迁移顺序。
composer require 安装 Yii2 扩展时为什么报错“could not find package”
常见原因是包名拼写错误、版本约束不兼容，或没在项目根目录执行命令。Yii2 扩展大多托管在 Packagist，但部分非官方扩展需手动添加仓库源，或使用完整命名空间（如 yii2tech/ar-softdelete 而非 ar-softdelete）。
实操建议：
- 先确认扩展是否在 Packagist 搜索到，注意作者前缀（如
yiisoft/yii2-bootstrap4、dektrium/yii2-user） - 执行前用
pwd检查当前路径是否为 Yii2 项目根目录（含composer.json和vendor/） - 若扩展来自 GitHub 私有库或旧版 fork，需先在
composer.json的repositories字段声明源地址 - 避免直接写
composer require some-extension，应写全名：composer require yiisoft/yii2-redis:^2.0
安装扩展后 php yii 命令报 Class not found
典型表现是控制台报 Class 'yii\redis\Connection' not found，即使 composer require yiisoft/yii2-redis 成功执行。本质是 Yii2 的自动加载机制未识别新扩展，或配置未生效。
实操建议：
- 检查
vendor/yiisoft/yii2-redis目录是否存在，不存在说明composer require实际失败（可加-vvv参数重试） - 确认
config/web.php或config/console.php中已注册组件，例如：'redis' => ['class' => 'yii\redis\Connection'] - 若扩展提供
Bootstrap类（如yii2mod/yii2-rbac），需在config/main.php的'bootstrap'数组中显式加入 - 运行
composer dump-autoload -o强制刷新自动加载映射（尤其在修改了composer.json后）
composer require 加版本号的坑：^2.0 vs ~2.0 vs 2.0.*
Yii2 生态里多数扩展遵循语义化版本，但不同符号对主版本升级行为差异极大，容易导致运行时异常或类方法缺失。
实操建议：
-
^2.0允许升级到2.9.9，但禁止升到3.0.0；适合稳定扩展，如yiisoft/yii2-redis:^2.0 -
~2.0.0等价于>=2.0.0 ，更保守，适合生产环境关键扩展（如 <code>dektrium/yii2-user:~0.9.12） - 完全省略版本（
composer require yiisoft/yii2-jui）会安装最新稳定版，但可能跳过兼容 Yii2.0.x 的旧版（比如某些扩展 v2.x 已只支持 Yii3） - 若项目用 Yii 2.0.43，别盲目上
yii2tech/yii2-upload:^1.0—— 它最低要求 Yii 2.0.45，否则启动时报Unknown Property
安装完扩展，为什么 Migration 不识别 yii migrate
常见现象是执行 yii migrate 时提示 “No new migrations found”，但扩展文档明确说它带 migration 文件（如 yii2mod/yii2-rbac）。根本原因在于 Yii2 的 migration 路径未包含扩展自带的 migrations 目录。
实操建议：
- 查看扩展文档确认 migration 路径，通常是
@vendor/author/package/migrations，例如@vendor/dektrium/yii2-user/migrations - 在
console/config/main.php中配置'controllerMap' => ['migrate' => ['class' => 'yii\console\controllers\MigrateController', 'migrationPath' => null, 'migrationNamespaces' => ['dektrium\user\migrations']] - 如果扩展没用命名空间方式组织 migration（老式写法），改用
'migrationPath' => '@vendor/dektrium/yii2-user/migrations' - 运行
yii migrate --migrationPath=@vendor/dektrium/yii2-user/migrations测试路径是否正确
最常被忽略的是：扩展的 migration 是否依赖其他扩展已存在的表（比如 user 表必须先由 yii2-user 创建，yii2-rbac 才能加权限字段）。顺序错了，迁移就会卡住。
