getDefinition 可获取类的未解析容器定义，需递归解析 Reference 并结合 @Value、Setter、属性注入等元信息构建依赖树，但无法处理条件绑定、代理类及运行时覆盖。
如何用 getDefinition 查看某个类的完整依赖树
Hyperf 的容器不直接暴露依赖图谱，但 getDefinition 能拿到类在容器中注册的原始定义（Definition 对象），里面包含构造函数参数、方法注入、属性注入等元信息。关键在于：它返回的是「未解析」的定义，即参数还是 Reference 或字符串形式，不是最终实例。
实操建议：
- 先确保目标类已通过
@Inject、@Value或配置方式注册进容器（否则getDefinition返回null） - 调用
$container->getDefinition(FooService::class)，检查返回值是否为Definition实例 - 从
$def->getArguments()拿构造参数列表，每个元素可能是：Reference（需递归查其目标类）、string（类名或别名）、mixed（字面量） - 注意：
getDefinition不处理条件绑定（如when）、代理类或运行时动态注册的定义（如makeWith临时构造）
为什么 getDefinition 返回的 Reference 无法直接看到目标类全名
Reference 是 Hyperf 容器内部用于延迟解析的占位符，它只存一个 $name 字段，这个字段可能是类名、别名、甚至带参数的表达式（如 "config:database.default"）。它本身不强制要求指向一个具体类——直到真正 get() 时才解析。
常见错误现象：
- 打印
$ref->getName()得到"App\Service\BarService"—— 这是理想情况 - 得到
"bar_service"—— 需查dependencies.php或@Inject("bar_service")绑定目标 - 得到
"config:app.debug"—— 这不是类，不能递归调用getDefinition - 得到空字符串或
null—— 表示该参数是运行时传入或匿名函数，无法静态分析
所以依赖链路分析必须配合配置文件和注解扫描，不能只靠 getDefinition 单点突破。
手动构建依赖关系图时最容易漏掉的三类注入
仅遍历构造函数参数会丢掉大量真实依赖，Hyperf 支持多种注入方式，它们不会出现在 getArguments() 中：
-
@Value注入：值来自配置，对应$def->getProperties()中的Value实例，需提取getValue()并判断是否为配置路径（如"app.name"） - Setter 注入（
@Inject在 public 方法上）：需用反射读取方法参数，再对每个参数调用getDefinition—— 注意方法可能被多次@Inject，且顺序不保证 - 属性注入（
@Inject在 public 属性上）：同样在$def->getProperties()中，但类型是Reference或Value，需单独处理
性能影响：深度递归调用 getDefinition 可能触发容器提前初始化某些单例（尤其当定义里有 Factory 时），调试阶段建议加缓存或限制递归层数（如 >5 层就截断）。
一个轻量级调试脚本：输出某服务的前两层依赖快照
以下代码可直接放在 bin/hyperf.php 中临时执行，避免启动整个 HTTP 服务：
// bin/hyperf.php 内追加
use Hyperf\Di\Container;
use Hyperf\Di\Definition\Definition;
$container = require __DIR__ . '/../runtime/container.php';
$service = App\Service\FooService::class;
function dumpDeps($container, $class, $depth = 0) {
if ($depth > 2) return;
$def = $container->getDefinition($class);
if (!$def instanceof Definition) {
echo str_repeat(' ', $depth) . "❌ {$class} not found in container\n";
return;
}
echo str_repeat(' ', $depth) . "✅ {$class}\n";
foreach ($def->getArguments() as $arg) {
if ($arg instanceof \Hyperf\Di\Definition\Reference) {
$target = $arg->getName();
echo str_repeat(' ', $depth + 1) . "→ {$target}\n";
if (class_exists($target)) {
dumpDeps($container, $target, $depth + 1);
}
}
}
}
dumpDeps($container, $service);
这个脚本不处理 setter/property 注入，但能快速验证构造链是否符合预期。真正复杂的服务依赖（比如涉及策略模式、工厂、条件绑定），必须结合 IDE 的「Find Usages」和 dependencies.php 手动补全。
最常被忽略的一点：Hyperf 的 getDefinition 不反映运行时覆盖（如测试中用 mock 替换），调试生产问题时务必确认当前环境加载的是哪份定义。
