@Inject 的 value 参数必须填服务的全限定类名（FQCN），如 Hyperf\Logger\Logger::class，不能填接口名、别名或小写路径，否则因容器查不到绑定而触发多实现冲突报错。
Inject 的 value 参数到底填什么
填接口全限定名（FQCN），不是类名，也不是别名。Hyperf 的 DI 容器在解析 @Inject 注解时，会直接把 value 当作「绑定标识」去容器里找对应服务。如果填 LoggerInterface::class，它就去找这个接口是否被 bind 过；如果没 bind，就会 fallback 到自动实例化——但此时若存在多个实现，就报错「无法确定具体实现类」。
常见错误现象：HyperfDiExceptionInvalidArgumentException: Cannot determine which class to instantiate for interface PsrLogLoggerInterface
- 确认你已在
dependencies.php中显式 bind：'PsrLogLoggerInterface' => HyperfLoggerLogger::class,
- 或在类属性上写明具体实现：
@Inject(value="Hyperf\Logger\Logger")
- 不要写
@Inject(value="logger")——除非你真在容器里 bind 了字符串键"logger"，且该键指向一个明确类
多态场景下为什么不能只靠类型提示
PHP 不支持运行时泛型，@Inject 仅靠属性类型声明（如 private LoggerInterface $logger;）无法区分同接口的多个实现。Hyperf 默认不启用「基于命名的注入推导」，也不会扫描构造函数参数名来匹配服务名。
使用场景举例：你需要同时注入「业务日志」和「审计日志」两个 LoggerInterface 实现，分别写入不同通道：
- 必须为每个实现注册唯一标识，例如：
'App\Logger\BusinessLogger' => HyperfLoggerLogger::class,<br><pre class="brush:php;toolbar:false;">'App\Logger\AuditLogger' => HyperfLoggerLogger::class,
- 然后在属性上指定：
@Inject(value="App\Logger\BusinessLogger") private LoggerInterface $businessLogger;
@Inject(value="App\Logger\AuditLogger") private LoggerInterface $auditLogger;
- 注意：不能省略
value——即使写了类型提示，Hyperf 仍会尝试按接口名查找，触发冲突
value 值大小写与命名空间必须严格匹配
Hyperf 的容器 key 是大小写敏感的字符串，value 传入的任何字符差异都会导致查不到绑定，进而触发自动实例化逻辑，最终因多实现而失败。
- 错误示例：
@Inject(value="hyperf\logger\logger")（小写 namespace）→ 查无此键 → fallback → 冲突
- 正确写法：
@Inject(value="Hyperf\Logger\Logger")
- 路径中所有
必须是双反斜线，单反斜线会被 PHP 解析为转义符，导致类名截断或语法错误 - 建议直接用
Foo::class常量，避免手敲出错：<pre class="brush:php;toolbar:false;">@Inject(value=HyperfLoggerLogger::class)
依赖注入层级深时 value 指定容易被忽略
当服务 A 依赖 B，B 又依赖 C（且 C 是多态接口），很多人只在 A 上处理注入，却忘了 B 内部对 C 的注入也需要显式指定 value。Hyperf 不会递归穿透解析「间接依赖」的歧义。
比如：OrderService 依赖 PaymentClient，而 PaymentClient 构造函数里有 LoggerInterface $logger ——这时光在 OrderService 里指定 @Inject 没用。
- 必须修改
PaymentClient的构造函数参数注解：public function __construct(#[Inject(value="App\Logger\PaymentLogger")] private LoggerInterface $logger) { ... } - 或者改用属性注入并在
PaymentClient类内加@Inject注解，同样要带value - 否则容器在构建
PaymentClient时，仍会因无法分辨LoggerInterface实现而中断
最易被忽略的是嵌套依赖里的注入点——它们不会继承外层的 value 指定，每个注入位置都得独立声明。
