hyperf 依赖注入中 interface 绑定实现类必须在 dependencies.php 中使用带命名空间的全限定名（如 app\contracts\userserviceinterface::class => app\services\mysqluserservice::class），且构造函数类型提示需用接口全名，否则会报 classnotfoundexception 或 cannot instantiate interface；配置后需运行 php bin/hyperf.php di:show 验证绑定是否生效，并执行 cache:clear 清缓存。
Hyperf 依赖注入里 interface 绑定到带命名空间的实现类
必须在 dependencies 配置中写全类名（含命名空间），否则容器找不到实现类，会抛出 ClassNotFoundException 或注入 null。
配置文件路径和格式要严格匹配 PSR-4 规则
Hyperf 默认从 config/autoload/dependencies.php 加载绑定关系，键是接口全限定名，值是实现类全限定名。注意：两者都必须带 \ 开头的完整命名空间，且大小写敏感。
- 接口定义在
App\Contracts\UserServiceInterface，实现类在App\Services\MySQLUserService - 配置必须写成：
App\Contracts\UserServiceInterface::class => App\Services\MySQLUserService::class - 不能省略
::class—— 字符串形式（如'App\Contracts\UserServiceInterface' => 'App\Services\MySQLUserService'）在 PHP 8.2+ 可能触发弃用警告，且不推荐 - 类文件物理路径需与命名空间一致，比如
App\Services\MySQLUserService必须位于app/Services/MySQLUserService.php
构造函数注入时类型提示必须用接口全名
控制器或服务中声明依赖，必须用接口的完整命名空间，否则 DI 容器无法匹配 bindings。
- ✅ 正确：
public function __construct(private App\Contracts\UserServiceInterface $userService) {} - ❌ 错误：
private UserServiceInterface $userService（缺少命名空间，PHP 解析为当前命名空间下的类） - 如果用了
use App\Contracts\UserServiceInterface，那构造函数里可以简写，但前提是use语句本身无误 - 运行时若报
Cannot instantiate interface，大概率是构造函数类型提示写错了，或dependencies.php没生效（检查是否在正确环境配置下被加载）
调试绑定是否生效的最快方式
别猜，直接在命令行跑 php bin/hyperf.php di:show，搜索你的接口名。如果没出现在列表里，说明配置没加载或类名拼错。
- 确保
dependencies.php返回的是数组，且 key 是接口类，value 是实现类 - 修改后记得清缓存：
php bin/hyperf.php cache:clear（Hyperf 3.x 默认启用注解缓存） - 如果使用了多环境配置（如
dev/dependencies.php），确认当前APP_ENV对应的配置被加载 - 类名拼错一个字母、多一个空格、命名空间末尾漏掉
\，都会导致绑定失败 —— 这是最常卡住的地方
use 语句加错，或者复制粘贴时漏掉命名空间里的 \。每次绑定不生效，先盯三秒 di:show 输出，比翻文档快得多。
