ConfigInterface注入失败主因是缺失use语句、未正确声明类型、未安装hyperf/config组件或配置未加载。需use Hyperf\Contract\ConfigInterface；用private ConfigInterface $config;配合@Inject；确保组件已安装且配置正常。
直接注入 ConfigInterface 没问题，但必须用 @Inject 注解 + 正确的类型提示，且类文件里不能漏掉 use 语句。
为什么 $config 属性注入后是 null 或报错？
常见现象是控制器里写了 @Inject 和 @var ConfigInterface，但运行时 $this->config 是 null，或者抛出 Cannot instantiate interface。
- 没加
use Hyperf\Contract\ConfigInterface;—— PHP 会把ConfigInterface解析成当前命名空间下的类（比如App\Controller\ConfigInterface），根本找不到接口定义 - 用了字符串类型提示，比如
private $config;配合@var \Hyperf\Contract\ConfigInterface，但注解解析失败（尤其在 PHP 8.2+ 的严格模式下更敏感） -
ConfigInterface不是自动绑定到容器的“默认服务”，它依赖hyperf/config组件已安装且配置加载正常；如果composer require hyperf/config没执行，或config/autoload/下缺少基础配置文件，容器压根不会注册这个接口
@Inject 注入 ConfigInterface 的标准写法
这是最常用、也最稳妥的方式。关键点全在声明上，不是靠猜测或缩写。
- 顶部
use必须完整：use Hyperf\Contract\ConfigInterface; - 属性声明必须带完整命名空间类型提示：
private ConfigInterface $config;（PHP 8.0+ 推荐）或/** @var ConfigInterface */ private $config; - 必须加
@Inject注解（不能只靠构造函数，因为ConfigInterface不是具体类，无法被自动推导）
示例：
use Hyperf\Contract\ConfigInterface;
use Hyperf\Di\Annotation\Inject;
<p>class IndexController
{</p><h1>[Inject]</h1><pre class="brush:php;toolbar:false;">private ConfigInterface $config;
public function index()
{
$driver = $this->config->get('databases.default.driver', 'mysql');
return ['driver' => $driver];
}}
不推荐的替代方式：助手函数和 @Value
虽然 config('key') 和 @Value("key") 也能读配置，但它们和 ConfigInterface 注入是不同机制，不能混为一谈：
-
config()是全局函数，不走 DI 容器，无法被 Mock 测试，也不支持运行时动态重载（比如监听器改了配置，config()可能还是旧值） -
@Value("key")本质是编译期注入，值在容器构建时就固化了；如果配置是运行时通过ConfigInterface::set()动态写的，@Value拿不到最新值 - 两者都不提供
get()的层级访问、默认值兜底、类型转换等完整能力（比如$config->get('redis.port', 6379)返回 int，而@Value("redis.port")总是 string）
调试注入是否生效的最快办法
别翻日志、别猜路径。打开终端，直接运行：
php bin/hyperf.php di:show | grep ConfigInterface
如果看到类似 Hyperf\Contract\ConfigInterface => Hyperf\Config\Config 的输出，说明绑定成功；如果没有，检查两件事：
-
composer require hyperf/config是否已执行（vendor/hyperf/config目录是否存在） -
config/autoload/packages.php或框架自动加载逻辑中，是否启用了Hyperf\Config\ConfigProvider
配置注入看着简单，但一旦命名空间写错、use 漏掉、或组件没装全，就会静默失败——这些地方比逻辑代码更容易卡住人。
