Yii依赖注入需在容器初始化前绑定接口，推荐用config/web.php中container.definitions；Yii::$container->set()须在createObject前调用，否则无效；接口名须完整命名空间，setter注入仅响应显式配置键名。
Yii 的依赖注入（DI）不是“配完就能用”的黑盒机制，它依赖两个关键时机：容器初始化前绑定、对象创建时解析。错过时机或混淆服务定位器（Service Locator）和 DI 容器（Yii::$container），90% 的注入失败都源于此。
container.definitions 和 Yii::$container->set() 哪个该用？
两者本质相同，但执行时机和适用场景不同：
-
container.definitions写在应用配置（如config/web.php）的'container' => ['definitions' => [...]]里，是推荐方式——它在应用启动早期、容器冻结前自动注册，安全可靠 -
Yii::$container->set()必须在Yii::createObject()或new之前调用，常见错误是写在控制器 action 里，此时容器已冻结，调用无效且无报错，后续createObject()仍抛InvalidConfigException: Failed to instantiate component - 接口绑定必须用完整命名空间字符串，比如
'app\interfaces\CacheInterface'，不能简写为'CacheInterface'或漏掉app\ - 第二个参数支持类名字符串（
'app\components\FileCache'）、匿名函数（注意别闭包引用$this）、或配置数组（['class' => 'app\components\DbCache', 'dsn' => 'sqlite:cache.db']）
setter 注入为什么配置写了却没生效？
Yii 的 setter 注入是显式驱动，不是反射扫描——它只响应配置中明确声明的键名，并严格匹配方法名规则：
- 配置项
'apiUrl' => 'https://api.example.com'会触发setApiUrl()，但'APIUrl'或'api_url'都不会 - 如果类只有
public $timeout;没有setTimeout()，配置'timeout' => 5会直接赋值给属性（不推荐，破坏封装） -
@propertyPHPDoc 注释纯属 IDE 提示，Yii 运行时不读取、不解析；写了@property User $user不等于自动注入$this->user - setter 方法必须是
public，且参数类型约束不能过严（例如声明string|null，但配置传了空字符串''，可能触发 TypeError）
服务定位器（Yii::$app）和 DI 容器（Yii::$container）有什么区别？
这是最常被混用、也最容易出问题的地方：
-
Yii::$app是服务定位器，管理的是“全局可访问的组件”，比如db、cache、mailer，定义在配置的components数组里，通过Yii::$app->db访问 -
Yii::$container是 DI 容器，负责“按需构造任意对象及其依赖”，比如new Controller时自动注入UserService，它不提供全局单例访问入口 - 你不能靠
Yii::$app->get('UserService')获取一个被set()绑定的接口实现——除非你同时把它注册为components中的一个组件 - 循环依赖（A 依赖 B，B 又依赖 A）在构造函数注入中会直接导致栈溢出；改用 setter 注入，或手动在
init()里调用Yii::$app->get()，是更可控的解法
真正难的不是语法，而是理解“绑定必须早于使用”这个铁律。很多看似随机的 InvalidConfigException，其实只是把 set() 放错了位置；而所有以为 @property 能自动注入的尝试，从一开始就没走对路。
