yii2组件配置必须放在应用配置的'components'数组下且仅在入口文件（如config/web.php）中生效；常见错误包括位置错误、环境覆盖、类加载失败、依赖缺失及权限问题。
组件配置写在了错误的位置
Yii2 的组件（如 cache、db、errorHandler）必须注册在应用配置的 'components' 数组下，且只能在入口配置文件中生效——通常是 config/web.php（Web 应用）或 config/console.php（CLI 应用）。常见错误包括：
- 把
'cache' => [...]写在'modules'或'params'里，完全不被识别 - 在控制器或行为中动态调用
Yii::$app->set('cache', ...)，但该调用晚于组件首次使用（比如Yii::$app->db已在bootstrap阶段触发），导致实际生效的是默认配置 - 高级模板中误将配置放在
environments/prod/common/config/main.php，却没在environments/prod/frontend/config/main-local.php中正确合并（Yii::configure()调用顺序错乱）
配置被环境或条件覆盖
组件配置可能被更高优先级的设置覆盖，尤其是开发/生产环境切换时：
-
YII_ENV值不是'dev'，导致environments/dev/...下的局部配置（如 Gii、debug 工具）根本没加载 - 在
config/web.php中写了'cache' => ['class' => 'yii\caching\FileCache']，但environments/prod/common/config/main-local.php又定义了一次'cache'，后者会完全覆盖前者（数组合并非递归） - 用了
Yii::createObject()手动构造组件实例，绕过了应用配置体系，此时Yii::$app->cache和你手动建的实例不是同一个对象
组件类未正确加载或依赖缺失
配置语法正确，但组件根本初始化失败，常表现为访问 Yii::$app->xxx 报 “undefined index” 或静默 fallback 到默认实现：
-
class值拼写错误，例如写成'yii\caching\MemcachedCache'（正确是MemCache）或大小写不一致（Linux 下敏感） - 依赖扩展未安装：配置了
'class' => 'yii\caching\RedisCache'，但 PHP 没装redis扩展，此时 Yii 不报错，只默默降级为NullCache - 缓存键用了纯数字（如
$key = time()），导致FileCache写入失败、MemCache返回false，看起来像配置没生效——实际是运行时行为异常 - 路径权限问题：
FileCache的cachePath目录不可写，组件初始化时静默失败，后续所有get()/set()都返回false
配置生效但行为不符合预期
组件已加载，但效果和你设想不同，这类问题最容易被当成“配置不生效”：
-
urlManager配置了'enablePrettyUrl' => true，但 Nginx/Apache 没配重写规则，请求压根没进 Yii，自然不走你的路由规则 -
errorHandler的'errorAction'设为'site/error'，但在YII_DEBUG=true下，框架强制显示调试页，完全不触发该配置 -
log组件配置了FileTarget，但runtime/logs/不可写，日志写入失败，你以为“没记录”，其实是权限问题而非配置无效 -
db配置了'tablePrefix'，但模型类没调用tableName()或用了硬编码表名，前缀根本没参与 SQL 构建
Yii::$app->getComponents() 返回的数组里有没有你的组件名，再检查它的 className 和 __isset() 行为。
