Hyperf中@Inject注解不生效怎么办_检查类是否被Scan扫描或代理类是否正常生成-php教程-PHP中文网

@inject不生效的根本原因只有两个：类未被容器扫描到或代理类生成失败。需检查scan.php路径配置、命名空间与物理路径一致性、类是否具体可实例化，并验证代理类是否生成及是否含正确注入逻辑。

hyperf中@inject注解不生效怎么办_检查类是否被scan扫描或代理类是否正常生成

根本原因通常只有两个：类没被容器扫描到，或者代理类生成失败导致依赖无法注入。Hyperf 的 @Inject 依赖注入完全基于 AOP 代理和注解扫描，缺一不可。

Hyperf 默认只扫描 app/ 目录下的类，如果你把需要注入的类（比如 Service）放在 library/、common/ 或自定义目录下，@Inject 就不会生效 —— 因为注解压根没被解析。

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

确认你的类所在路径是否在 config/autoload/scan.php 的 paths 数组中，例如：

'paths' => [<br>    BASE_PATH . '/app',<br>    BASE_PATH . '/common', // 若 Service 在 common/ 下，必须加这一行<br>],

Hyperf 在启动时会为带 @Inject 的类生成代理类（如 App\Service\UserService$$Proxy），若生成失败，注入就静默失效 —— 不报错，但属性值为 null。

运行 php bin/hyperf.php di:proxy，观察输出是否有类似 Generate proxy for App\Service\UserService 的日志；若没有，说明该类未被识别为可代理目标
检查类是否被 @Aspect、@Controller、@Service 等注解标记（任一即可），否则默认不触发代理生成
代理类生成后会存于 runtime/container/proxy/，可直接查看对应 .php 文件是否存在、内容是否含 parent::__construct() 和 $this->property = $container->get(...) 逻辑
开发环境建议开启 SWOOLE_HOOK_ALL 并禁用 opcache（opcache.enable=0），避免代理类加载失败

有些问题看似是 @Inject 失效，实则是使用姿势或生命周期问题。

构造函数里访问 @Inject 属性会得到 null —— 因为属性注入发生在构造函数执行之后，应改用 __construct 参数注入或 @PostConstruct 回调
手动 new 出来的对象（如 new UserService()）不会被容器管理，@Inject 完全无效；必须通过 $container->get(UserService::class) 获取
如果类同时用了 @Inject 和 __construct 参数注入，Hyperf 默认优先走构造函数注入，此时属性注入会被跳过
检查是否误用了 @Value 或 @Config 注解拼写错误，导致 IDE 或扫描器误判整个类注解结构异常

Hyperf 的注入机制很“刚”：不扫描就不认，不代理就不注，不走容器就不管。真正难排查的往往不是配置错，而是你以为它该生效的地方，其实根本没进扫描链或代理链。