Yii2组件可运行时替换，只需在config/web.php中覆盖components配置，新类须继承原类并正确处理构造与init方法，重写需注意方法签名、返回值类型及生命周期钩子。
直接替换 config/web.php 里的组件配置就行
Yii2 的组件系统支持运行时替换，不需要动 vendor/yiisoft/yii2 下的源码，也不用改 Application 类。只要新建一个继承自原类的新类，然后在 config/web.php 的 components 数组里覆盖同名键即可。
比如要重写 request 组件，只需定义 'request' => ['class' => 'app\components\CustomRequest']；框架启动时会自动实例化你的类，而不是默认的 yii\web\Request。
- 所有被替换的组件必须继承原始类（如
yii\web\Request），否则方法签名或事件触发会出错 - 配置项会自动传入构造函数，所以新类必须兼容
$config = []参数形式 - 若重写了
__construct()，末尾一定要调用parent::__construct($config) - 若重写了
init()，开头必须调用parent::init()，否则行为和事件机制可能失效
重写 ErrorHandler 时 renderException() 必须返回字符串
自定义异常渲染逻辑最常见，但容易卡在返回值类型上：如果 renderException() 方法没返回 string，页面会白屏且无错误提示，日志里也看不到明显线索。
正确做法是，在重写方法中判断环境、异常类型，最后统一 return 一段 HTML 字符串（或调用 $this->renderView() 并确保它返回字符串）。
- 开发环境可返回带堆栈的调试页，生产环境应返回精简的 500 页面
- 不要直接 echo 或 print 输出内容，这会导致响应体混乱
- 若调用
parent::renderException($exception)，它本身不输出，只返回字符串，可作为 fallback - 注意
logException()和renderException()是两个独立入口：前者只管记录，后者只管输出
重写 ActiveRecord 或 Connection 类时小心主键与旧属性逻辑
比如重写 primaryKey() 或底层数据库连接类（如 yii\db\Connection、yii\mongodb\Connection），最容易踩的坑是绕过框架对 _oldAttributes 和主键字段的隐式管理。
以 BaseActiveRecord::primaryKey() 为例，框架内部依赖该方法返回的字段名去比对变更、生成 UPDATE WHERE 条件。如果你返回了错误字段，或漏掉复合主键中的某一项，save() 可能更新错行甚至全表。
- 不要在
primaryKey()里硬编码值，应基于模型实际结构动态返回数组 - 若重写
beforeSave()或afterFind()，注意$this->_oldAttributes是否已正确初始化 - MongoDB 场景下，
CMConnection类重写常涉及字段类型转换，务必保证save()前后数据类型一致，否则写入 null 或报 BSON 错误 - 所有重写都建议加单元测试，验证主键读取、批量更新、软删除等边界行为
用 Yii::createObject() 实例化时注意参数顺序
当你在代码里手动创建被重写的组件（比如在 controller 里 new 一个定制 request），别直接 new，优先走 Yii::createObject() —— 它能保证配置合并、依赖注入和生命周期钩子正常触发。
典型错误写法：new CustomRequest(['enableCsrfValidation' => false])；正确写法是：Yii::createObject(['class' => CustomRequest::class, 'enableCsrfValidation' => false])。
- 前者跳过了
Object构造流程，init()不会被调用，行为类、事件绑定全部丢失 - 后者会走完整生命周期：构造 → 配置赋值 →
init()→ 返回实例 - 如果类构造函数有必填参数（如
__construct($host, $port, $config = [])），要用数组第二项传参：Yii::createObject([...], [$host, $port])
实际项目里，重写核心类最麻烦的不是写代码，而是厘清“哪里调用了它”和“它又被谁依赖”。比如重写 UrlManager 后，Controller::createUrl()、Html::a()、甚至 RBAC 的路由匹配都会受影响。上线前一定得跑一遍全站链接生成和路由解析逻辑。
