TP6中不能直接用ReflectionClass获取控制器注解，因路由调度未实例化类且$request->controller()仅返回无命名空间的标识符；须通过Route::getRule()->getDispatch()->target获取真实类名，校验存在后再反射。
TP6 中不能直接用 ReflectionClass 获取当前执行控制器的注解——因为 ReflectionClass 只能反射「已加载的类」，而 TP6 的路由调度可能尚未实例化控制器类，甚至目标可能是闭包或字符串路径。
为什么 ReflectionClass 拿不到当前控制器的注解
常见错误现象：new ReflectionClass($request->controller()) 报 Class 'Index' not found；或即使类存在，也读不到方法注释，因为没指定完整命名空间、后缀、大小写不匹配。
根本原因在于：$request->controller() 返回的是路由解析出的标识符（如 "User"），不是真实类名；它不包含命名空间、不反映 app/controller_suffix 配置（比如是否带 Controller 后缀），更无法保证该类已被 include 或 autoload 加载。
- TP6 默认控制器类名是
app\controller\UserController，但$request->controller()可能返回"User" - 若配置了
'controller_suffix' => false，类名可能是app\controller\User，但反射时仍需手动拼接 - 若路由绑定的是
['app\controller\User', 'read']或'app\controller\User/read'，ReflectionClass才有明确目标
正确获取控制器类 + 方法注解的路径
必须先拿到真实调度目标，再做反射。TP6 提供了稳定入口：Route::getRule()->getDispatch()->target。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 在中间件或全局钩子中使用：
$dispatch = Route::getRule()->getDispatch(); - 判断
$dispatch->type类型：'class'、'function'或'method' - 若为
'class'或'method'，$dispatch->target是数组（如['app\controller\User', 'index']）或字符串（如'app\controller\User/index'），需先标准化成类名+方法名 - 拼出完整类名后，用
class_exists()校验，再new ReflectionClass()——否则反射会失败 - 方法注释用
(new ReflectionMethod($class, $method))->getDocComment()，不是ReflectionClass::getMethods()直接遍历（那会拿到所有方法，含父类）
getDocComment() 解析注解的注意事项
PHP 的 getDocComment() 返回原始 docblock 字符串（含 /** 和 */），需自行解析，不能直接当结构化数据用。
常见坑点：
- 正则提取
@xxx时，注意换行和空格：preg_match('/@([a-zA-Z0-9_]+)\s+(.*?)(?:\r\n|\n|$)/s', $doc, $matches) - 多个同名注解（如多个
@param）需用preg_match_all，否则只取第一个 - 注释里有中文或特殊符号时，确保文件编码为 UTF-8，且正则加
u修饰符 - TP6 注解路由（如
@route）默认不启用，需手动开启并注册注解解析器，否则getDocComment()读到的只是普通注释
缓存反射结果避免性能损耗
每次请求都新建 ReflectionClass 实例开销不小，尤其在中间件中高频调用时。
建议做法：
- 用静态变量或
think\Cache缓存已解析过的类/方法注解，键名可为$className . '::' . $methodName - 开发环境可关掉 OPcache 或设短 TTL，便于调试；生产环境务必开启 OPcache 并设置合理缓存时间
- 避免在循环中反复反射同一类——提取一次，复用其
getMethods()结果 - 若仅需某几个特定注解（如
@auth、@log），解析后立刻return，别全量提取再过滤
最易被忽略的一点：反射前没检查类是否存在或是否可访问（is_callable 不等于 class_exists），导致静默失败或报错中断流程。务必把 class_exists($fullClassName) 和 method_exists($fullClassName, $method) 当作前置守门员。
