hyperf路由参数正则约束必须直接写在路由定义的path字符串花括号内，仅注解路由和router::addroute()有效；如#[httpget(path: "/user/{id:\d+}")]，而router::get()等快捷方法不支持。
Hyperf 路由参数的正则约束，不是在中间件、验证器或控制器里配的，而是直接写在 路由定义本身 的 path 字符串中——只对注解路由和 Router::addRoute() 有效，且必须放在花括号内。
注解路由怎么写正则
在 #[HttpGet]、#[PostMapping] 等注解的 path 参数里，用 {参数名:正则表达式} 格式：
-
#[HttpGet(path: "/user/{id:\d+}")]→ 只匹配 ID 是纯数字的 GET 请求，非数字直接 404 -
#[GetMapping(path: "/post/{slug:[a-z0-9\-]+}")]→ 匹配小写字母、数字、短横线组成的 slug -
{id:[0-9]+}和{id:\d+}等价；但{id:\d*}允许空字符串，容易出问题，慎用
⚠️ 注意：#[GetMapping("/user/{id}")] 这种写法 没有正则，后续手动校验 ID 类型就晚了——请求已进控制器，浪费资源。
配置文件路由（routes.php）怎么加正则
在 config/routes.php 中，用 Router::addRoute()，path 同样支持内联正则：
Router::addRoute('GET', '/article/{id:\d+}', 'App\Controller\ArticleController::show');Router::addRoute(['GET', 'HEAD'], '/status/{env:[a-z]+}', [...]);
❌ Router::get() 和 Router::post() 这类快捷方法 不支持路径参数和正则，带变量必须改用 addRoute()。
在SEO发布前，从路由清单生成XML网站地图和robots.txt
下载
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
哪些地方不能写正则
以下场景写了也无效，别白费功夫：
- 控制器方法参数类型提示（如
public function show(int $id)）→ 这是 PHP 类型转换，不是路由匹配 - @Param 或 @Query 注解 → 它们管的是参数注入和验证，不影响 URL 是否被路由识别
- ValidationMiddleware 或手动
$this->validate()→ 属于业务层校验，404/405 已经发生过了
正则约束的本质，是在 FastRoute 匹配阶段就做路径过滤，早拦早省事。
怎么确认正则生效了
别靠猜，用 Hyperf 自带命令看真实注册结果：
- 执行
php bin/hyperf.php route:list - 找到对应路由，检查
PATH列是否显示/user/{id:\d+}（不是/user/{id}） - 再用 curl 测试非法值：比如访问
GET /user/abc，应返回 404，而不是进控制器报错
如果 route:list 里没看到正则，大概率是注解没扫描到，回头检查 config/autoload/annotations.php 的 scan 和 paths 配置。
