autocontroller注解未生效的主因是注解扫描未启用，需确认annotations.php中scan为true、paths包含正确控制器路径、已安装相关组件并执行composer dump-autoload。
AutoController 注解为什么没生效？
最常见原因是注解扫描根本没开，不是代码写错，而是框架压根没读你的类。Hyperf 默认不自动扫描注解，必须手动启用。
检查 config/autoload/annotations.php 是否满足以下三点：
-
'scan' => true必须为布尔true，不能是字符串"true" -
'paths'数组里明确包含控制器目录，例如'app/Controller'（注意不是App/Controller或带尾部斜杠） - 确认已安装
hyperf/annotation和hyperf/http-server，运行composer show hyperf/annotation验证
改完配置后，务必执行 composer dump-autoload，否则新类不会被自动加载器识别——这是 80% 的“注解不生效”真实原因。
prefix 参数写成 '/api/' 会导致路由 404
#[AutoController(prefix: '/api/')] 看起来很规范，但实际会多出一个斜杠，导致最终注册的路径变成 /api//index，FastRoute 不匹配。
正确写法只有两种：
-
#[AutoController(prefix: '/api')]—— 路径结尾不加斜杠 -
#[AutoController(prefix: 'api')]—— 也不加开头斜杠，Hyperf 会自动补全
验证方式：运行 php bin/hyperf.php route:list，看输出中是否为 GET | /api/index。如果显示 /api//index 或 /apiindex，就是 prefix 写错了。
AutoController 和 Controller 注解混用会冲突
@AutoController 是“全自动”模式：所有 public 方法默认暴露为 GET/POST，路径由类名+方法名推导（如 IndexController::index → /index）；而 @Controller 必须配合 @GetMapping 等显式注解才生效。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
如果在同一个类上同时写 #[AutoController] 和 #[Controller]，或在 @AutoController 类里又给某个方法加 @GetMapping，Hyperf 会忽略后者，且不报错——你写的注解直接被吞掉。
选型建议：
- 快速原型、CRUD 接口多 → 用
@AutoController，省事但灵活性低 - 需要细粒度控制方法级 HTTP 方法、路径、中间件 → 改用
@Controller+@GetMapping/@PostMapping - 不要在一个项目里两种风格混用，尤其不要在同一个控制器类里交叉使用
IDE 提示失效或跳转不到方法？
PHPStorm 默认不认识 @AutoController 这类注解，不装插件就只能靠猜——这不是 Hyperf 的问题，是 IDE 缺少语义支持。
必须安装两个插件：
-
PHP Annotations：提供注解语法高亮和基础跳转（关键！） -
Swoole IDE Helper：补全 Swoole 和 Hyperf 核心类的类型提示
装完后重启 IDE，再检查 IndexController 类顶部是否有灰色警告。如果没有，说明注解已被识别；此时按住 Ctrl（Windows/Linux）或 Cmd（macOS）点击 @AutoController 应能跳转到定义处。否则插件未生效或配置有误。
这个环节容易被跳过，但一旦缺失，开发效率断崖式下降——写错注解没提示，改了路由不生效也看不出哪行有问题。
