hyperf 中需显式绑定接口与实现类，否则 container::get() 会抛出 notfoundexception；推荐通过 configprovider 在 provides() 中配置 dependencies 映射，或运行时用 container::set() 手动绑定，注意绑定时机、扫描路径及命名空间一致性。

Hyperf 中如何绑定接口到实现类

Hyperf 默认不自动绑定接口和实现类，必须显式配置，否则 Container::get(YourInterface::class) 会抛出 NotFoundException。绑定不是“写个类就行”，而是要告诉 DI 容器：当有人请求这个接口时，用哪个具体类来实例化。

使用 ConfigProvider 在服务提供者中绑定

这是最规范、可复用的方式，适合模块化项目。在服务提供者的 provides() 方法里返回绑定映射，或在 publishes() 中注册到容器。

Hyperframes Creative

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

下载

• ConfigProvider 必须被 scan 到（确保已加入 config/autoload/scan.php 的 paths）
• 绑定写法示例：

  return [
      'dependencies' => [
          YourInterface::class => YourServiceImpl::class,
      ],
  ];

• 如果实现类有构造参数依赖，Hyperf 会自动注入；但若需自定义初始化逻辑（如传参、单例控制），得改用 Container::set() 或闭包绑定

运行时用 Container::set() 手动绑定（仅限调试或特殊场景）

不推荐在业务代码中长期使用，但对临时替换、测试 Mock、AOP 替换等很直接。

• 在 main.php、ServerStartListener 或命令行启动逻辑中调用：

• Container::get(ContainerInterface::class)->set(
      YourInterface::class,
      new YourServiceImpl($dependency)
  );

• 注意：必须在首次 get() 之前执行，否则已缓存的实例不会更新
• 若绑定的是闭包，记得处理单例问题：Container::set(YourInterface::class, function () { return new YourServiceImpl(); });

常见错误：接口没绑定却直接 __construct 注入

报错典型信息是：Hyperf\Di\Exception\NotFoundException: Class YourInterface does not exist 或更隐蔽的 Cannot instantiate interface。

• 检查 config/autoload/dependencies.php 是否遗漏该条目（注意文件是否被正确加载）
• 确认接口名和实现类名拼写完全一致（含命名空间，大小写敏感）
• 如果实现类在非标准路径（比如 app/Services/Impl/），确保其已被 scan 覆盖，否则类加载失败导致绑定无效
• CLI 命令或测试环境下，scan 配置可能与 HTTP Server 不同，需单独验证

Hyperf 的绑定本质是容器映射，没有“自动发现接口实现”机制，哪怕只有一个实现类也必须声明。最容易忽略的是扫描路径遗漏和环境差异导致的绑定失效。