Hyperf中Service类必须用@Inject注解注入，不支持构造函数自动注入；需配合@Service注解、类型提示及正确扫描路径，否则报“null given”错误。
Hyperf 中 Service 类必须用 @Inject 注入
Hyperf 默认不支持构造函数自动注入，Service 类不能靠 __construct 参数直接接收依赖，必须显式使用 @Inject 注解。这是和 Laravel 或 Spring 最直观的差异点，新手常在这里卡住，报错类似 TypeError: Argument 1 passed to Xxx::__construct() must be an instance of Yyy, null given。
正确做法是：在属性上加 @Inject，并声明类型提示；类本身需被容器管理（即已通过注解或配置注册）。
- Service 类顶部必须有
@Bean或@Service注解（推荐后者，语义更明确） - 注入属性需为
public或protected，且带类型声明（如protected UserService $userService;） - 确保该 Service 类所在命名空间已启用注解扫描（
scan配置里包含其路径）
为什么 new UserService() 不行
手动 new UserService() 会绕过 Hyperf 容器，导致所有依赖（比如 Db、Redis、其他 @Inject 属性）都为 null，后续调用直接报错。Hyperf 的 DI 容器只在对象由 ApplicationContext::get() 或注解驱动创建时才完成依赖填充。
常见错误场景：
- 在 Controller 方法里写
$service = new UserService(); - 在非容器管理的工具类中试图 new 一个带
@Inject属性的 Service - Service 类没加
@Service，但尝试在其他类里@Inject它 —— 容器根本找不到这个类
@Inject 不生效的三个高频原因
即使写了注解，也常因环境或配置问题失败。重点排查以下三点：
-
@Service类没放在scan配置覆盖的目录下（默认只扫app/，如果你放在app/Services/就没问题；但若放src/Service/，就得改config/autoload/scan.php） - PHP 文件末尾少了空行，或用了 BOM 头，导致注解解析器跳过整个文件（用
file -i xxx.php检查编码） - 开发时开了
opcache.enable=1但没清缓存，修改注解后不生效（执行php bin/hyperf.php di:scan并重启服务）
想在非容器类里用 Service 怎么办
比如在命令行脚本、单元测试或全局函数里，没法用 @Inject，就得手动从容器取：
use Hyperf\Utils\ApplicationContext; $service = ApplicationContext::getContainer()->get(UserService::class);
注意：ApplicationContext::getContainer() 必须在 Hyperf 应用已启动后调用（如 main 函数之后），否则会返回空容器。CLI 命令中可放心用，但纯 PHP 脚本里要先触发框架初始化（一般不建议这么干）。
别硬套 new，也别试图在非注解类里写 @Inject —— 注解只在容器管理的类里被解析。
