Hyperf构造方法注入需类被容器管理且参数有对应绑定，直接类型提示即可自动注入；失败主因是类未扫描、未绑定或手动new实例；可混用@Inject但不推荐；运行时参数需改用方法传参、@Value或$container->make()。
Hyperf 构造方法注入的写法
Hyperf 默认支持通过构造方法自动注入依赖，前提是类被容器管理（即已注册为单例或通过 @Inject 注解声明），且参数类型有对应可解析的服务绑定。
最简写法就是直接在 __construct() 参数中写类型提示，Hyperf 容器会按类型自动解析并传入：
class UserService
{
private UserRedisService $redisService;
public function __construct(UserRedisService $redisService)
{
$this->redisService = $redisService;
}
}
注意：不需要手动调用 $container->get()，也不需要在构造函数里写 parent::__construct() —— Hyperf 的 DI 容器会在实例化时自动完成依赖装配。
为什么构造注入不生效？常见原因
构造注入失败通常不是语法问题，而是容器没“认出”你要注入的类。以下情况会导致注入为空或抛出 EntryNotFoundException：
-
UserRedisService类没有被正确扫描到（比如不在scan.directory配置路径下） - 该类没有使用
@Inject或未被显式绑定到容器（如未在dependencies.php中配置） - 类型提示用了接口但未绑定实现（例如写了
UserCacheInterface $cache，但没在dependencies.php里配UserCacheInterface::class => RedisCache::class） - 类被
new手动实例化（绕过了容器），此时构造函数参数不会被注入，全为null
验证方式：在构造函数里加 var_dump($redisService); die;，如果输出 null，基本是上面某条没满足。
构造注入和 @Inject 属性注入能混用吗？
可以，但不推荐混用。Hyperf 允许你在同一个类里既写构造注入，又加 @Inject 属性注解，但要注意执行顺序和可测试性：
- 构造参数优先于
@Inject属性注入执行（先构造，再属性赋值） - 如果构造参数依赖某个
@Inject属性（比如在__construct()里就调用$this->cache->get()），会出错——因为属性还没注入 - 单元测试时，构造注入更易 mock；
@Inject依赖反射，对测试不友好
建议统一用构造注入，除非确实需要延迟加载（比如某个依赖只在特定方法里用，且初始化开销大），才考虑用 @Value 或懒加载代理。
带参数的构造函数怎么处理？
Hyperf 不支持直接向构造函数传「运行时参数」（比如 new UserService($id) 这种），所有构造参数必须是容器能解析的类型。如果你需要动态值，有三种常用解法：
- 把动态值作为方法参数，而不是构造参数（推荐）：
public function getUserById(int $id): array { ... } - 用
@Value注入配置项（如@Value("app.name") private string $appName;） - 手动从容器获取带参数的实例：
$user = $container->make(UserService::class, ['id' => 123]);，但需提前在UserService的__construct中声明可选参数并提供默认值，否则容器无法匹配
真正容易被忽略的是最后一点：Hyperf 的 make() 只支持传「命名参数」（即数组键名要和构造函数参数名完全一致），且该参数不能有类型约束（否则容器无法绕过类型检查）。所以别写 function __construct(private int $id) 后还指望 make(..., ['id' => '123']) 自动转型 —— 它不会帮你做类型转换。
