iris可通过正则约束在路由层排除关键字，如{name:string regexp:^(?!admin$|root$).+$}，确保匹配时直接404；而by绑定不校验，registerparamfunc仅做参数解析校验返回400。
用 requirements 配合正则排除关键字
Iris 不像 Symfony 那样原生支持 requirements 字段，但你可以通过手动注册路由 + 正则约束实现等效效果。关键不是靠控制器 By 绑定，而是直接在 app.Get() 等方法中传入正则表达式作为参数类型约束。
例如，你想让 /user/{name} 匹配所有用户名，但排除 admin 和 root：
<pre class="brush:php;toolbar:false;">app.Get("/user/{name:string regexp:^(?!admin$|root$).*$}", func(ctx iris.Context) {
name := ctx.Params().Get("name") // 此时 name 已确保不是 "admin" 或 "root"
ctx.WriteString("Hello " + name)
})
注意：regexp:^((?!admin$|root$).)*$
administer；更安全的是用 ^(?!admin$|root$).+$——只在开头做负向断言并要求至少一个字符。
- 必须写
$锚定结尾，否则/user/admi也会被接受 - 不能省略
string类型标注，Iris 要求显式声明类型才能启用正则解析 - 多个关键字用
|分隔，不要加空格，如admin$|root$|test$
为什么 By 参数绑定不适用于排除逻辑
By 绑定只负责把路径参数按名注入方法参数，它不做任何校验或过滤。即使你写了 ByName string，Iris 依然会把 /user/admin 的 admin 原样传进去——后续得靠业务代码 if name == "admin" { return } 拦截，这属于运行时检查，不是路由层排除。
真正的“排除”必须发生在路由匹配阶段，否则：
- 请求仍会进入该 handler，浪费一次调用开销
- 无法与其他同路径的更精确路由（如
/user/admin/dashboard）正确竞争优先级 - 404 不够干净：用户看到的是 handler 报错，而不是根本没匹配上
避免正则陷阱：锚点、贪婪与空字符串
常见错误是写成 regexp:^(?!admin).*$，它允许 /user/admins，也允许空字符串 /user/——而后者通常不该被接受。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
推荐组合：
- 排除单个词且禁止子串：
regexp:^(?!.*admin).+$（但性能略差） - 排除精确值且拒绝空：
regexp:^(?!admin$|root$).+$（最常用） - 排除多个固定词：
regexp:^(?!admin$|root$|test$).+$ - 若需兼容大小写：
regexp:(?i)^(?!admin$|root$).+$，注意(?i)作用域仅限当前组
测试时务必覆盖边界情况：/user/、/user/admin、/user/Admin（大小写）、/user/adminx，确认只有目标值被拒。
想复用规则？封装成自定义参数类型
如果多个路由都要排除相同关键字，重复写正则容易出错。可以提前注册一个自定义参数类型：
<pre class="brush:php;toolbar:false;">iris.RegisterParamFunc("safeName", func(param string) (interface{}, error) {
if param == "admin" || param == "root" || param == "test" {
return nil, errors.New("forbidden name")
}
return param, nil
})
app.Get("/user/{name:safeName}", func(ctx iris.Context) {
name := ctx.Params().Get("name") // 这里 name 已通过校验
})
这种方式把排除逻辑从正则移到 Go 代码里，可读性更强，也方便加日志或动态加载黑名单。但注意：它发生在参数解析阶段，不是路由匹配阶段，所以 /user/admin
真正需要 404 的场景，还是得回到正则方式；需要详细错误提示或审计的，才选 RegisterParamFunc。
