Hyperf 的 @RequestMapping 通过注解扫描与 AOP 代理在容器启动时生成路由映射表，由 Router 和 Dispatcher 调度执行；要求类标注 @Controller 或启用 HTTP 扫描、方法非 private/static，且需显式指定 method（默认仅 GET），路径支持占位符，404 多因扫描路径未覆盖、类为 final 或组件未启用。
Hyperf 中 @RequestMapping 绑定方法的底层机制
Hyperf 的 @RequestMapping 不是直接“绑定”到方法上执行，而是通过注解扫描 + AOP 代理，在容器启动时生成路由映射表。它本质是告诉 Hyperf：“这个方法要响应某个 HTTP 路径和方法”，真正调用靠的是框架内部的 Router 和 Dispatcher 调度器。
所以你写在 Controller 方法上的 @RequestMapping，必须满足两个前提才能被识别：
- 类必须被
@Controller或@Service（且启用了 HTTP 扫描）标注 - 方法不能是
private，且不能有static修饰符
@RequestMapping 的 path 和 method 参数怎么配才生效
常见错误是只写路径不指定方法，结果 GET 请求能进，POST 却 404 —— 因为默认只匹配 GET。Hyperf 的 @RequestMapping 默认 method 是 ["GET"]，不是全方法通配。
实操建议：
- 显式声明 method：比如
@RequestMapping(path="/user", method={"POST"}) - 多个方法用数组：
@RequestMapping(path="/user", method={"GET", "PUT"}) - 别用字符串拼接 path：路径开头不加
/会被自动补，但结尾加了/就真带斜杠匹配，容易漏匹配 - path 支持变量占位：
@RequestMapping(path="/user/{id}")，对应方法参数需用@RequestParam("id")或@PathVariable("id")接收
为什么写了 @RequestMapping 却 404？检查这几点
这不是代码没写对，而是环境或配置卡住了。最常踩的坑集中在扫描和依赖注入层面：
- Controller 类没放在
config/autoload/scan.php配置的扫描路径下（默认是App\Controller\**） - 类用了
final关键字 —— Hyperf 依赖反射代理，final类无法被 AOP 增强，注解失效 - 没启用
Hyperf\HttpServer\Server组件，或者server.php里没配置httpserver - 使用了
@AutoController又叠了@RequestMapping—— 后者会覆盖前者规则，但路径拼接逻辑容易出错，建议二选一
替代方案：@GetMapping/@PostMapping 更安全
如果你只是做常规 REST 接口，直接用快捷注解更省心。它们是 @RequestMapping 的封装，语义明确、不易配错，而且 IDE 支持更好（比如 PHPStorm 能跳转、校验 path 重复）。
例如：
@GetMapping("/user/{id}")
public function getUser(int $id): Response
{
// ...
}
注意：这些快捷注解底层仍走 @RequestMapping，所以扫描、代理、路径规则完全一致 —— 它们只是语法糖，不是新机制。
真正容易被忽略的是：Hyperf 的路由注册发生在 Di 容器初始化阶段，任何运行时动态修改 @RequestMapping 注解的行为（比如反射改属性）都无效。想改路由逻辑，得换 Router 实现或加中间件拦截。
