hyperf官方不支持autocontroller，它并非核心组件，而是社区魔改、旧版残留或概念混淆所致；标准做法是显式使用@controller或路由注解配合abstractcontroller。
Hyperf 的 AutoController 不是官方支持的控制器类型，它不存在于 Hyperf 核心中 —— 你看到的很可能是社区魔改、旧版残留或混淆了 Swoole 的 AutoRoute 概念。
为什么找不到 AutoController 类或文档
Hyperf 官方路由机制基于注解（@GetMapping、@PostMapping）或配置式注册，不提供自动反射生成控制器的机制。所谓“AutoController”常见于以下几种误用场景：
- 把
AbstractController误记为AutoController - 在某些私有 fork 或中间件封装中，有人自行实现了按文件名/方法名自动绑定路由的逻辑，但非标准行为
- 与 Laravel 的自动资源控制器（
php artisan make:controller --resource）概念混淆 - 误将 Swoole HTTP Server 的
auto_coroutine或handle回调当作控制器抽象
想实现类似“自动注册控制器”的效果，该怎么做
Hyperf 支持通过自定义命令 + 注解扫描 + 路由批量注册来模拟“自动”行为，但需手动触发且不推荐用于生产环境核心路径。实际可行做法包括：
- 用
Command扫描app/Controller下所有类，读取其@RequestMapping注解并调用Router::addRoute() - 在
config/autoload/routes.php中用glob()动态加载控制器配置（不推荐：破坏配置缓存，启动变慢） - 继承
AbstractController并统一约定方法命名（如indexAction→ 自动映射GET /{class}/），再配合中间件做运行时路由分发 —— 这需要自己写Dispatcher，复杂度高、调试困难
示例（简易注解扫描注册）：
// 在自定义 Command 中
foreach (glob(app_path('Controller') . '/*.php') as $file) {
$className = 'App\Controller\' . basename($file, '.php');
if (class_exists($className)) {
$ref = new ReflectionClass($className);
$route = $ref->getDocComment();
// ……提取 @GetMapping 等并注册
}
}
真正该用的标准控制器写法
Hyperf 推荐且稳定的方式就是显式定义控制器类，配合注解声明路由。这是可调试、可测试、可缓存、兼容热更新的唯一可靠路径：
- 控制器必须继承
AbstractController（非必须，但方便用$this->response等） - 每个方法必须带明确的 HTTP 方法注解，如
@GetMapping("/user/{id}") - 参数绑定依赖
@RequestParam、@RequestBody、@PathVariable，不靠方法名或顺序自动推断 - 类名和文件名无隐式路由关系 ——
UserController不会自动对应/user，必须写注解或配置
一个最小可用控制器：
namespace AppController;
use HyperfHttpServerAnnotationGetMapping;
use HyperfHttpServerControllerAbstractController;
class UserController extends AbstractController
{
#[GetMapping("/user/{id}")]
public function view(int $id)
{
return $this->response->json(['id' => $id]);
}
}
真正麻烦的地方不在“怎么写控制器”，而在于试图绕过注解显式声明去追求“自动”——这会让路由逻辑散落在文件系统、命名规则、运行时反射里，出错时连 hyperf route:list 都看不到真实注册结果。
