@url()反向路由完全依赖conf/routes中显式定义的命名路由,缺名、拼错、大小写不符或含多余空格均导致静默失效并生成404链接;参数名须与路由占位符严格一致且值不可含斜线。

Revel 模板里的反向路由只靠 @url(),没别的入口;它不查函数签名、不运行时推导,全靠 conf/routes 里那行命名路由——缺名字、拼错名、大小写不对,@url() 就静默失效,生成的链接 404。
conf/routes 中必须显式命名所有要反向引用的路由
Revel 不会自动给未命名路由分配别名。@url() 查的是 routes 文件里控制器动作那一列的完整标识符(如 Hotels.Show),不是函数名也不是路径。没写这行,或者写成 GET /hotels/:id Hotels.show(小写 show),@url("Hotels.Show", "id": 123) 就完全不匹配。
- 必须确保
conf/routes中该路由行末尾没有多余空格或注释干扰解析 - 控制器名和方法名大小写必须与 Go 源码中
func (c Hotels) Show(...)完全一致 - 若用通配路由如
GET /:controller/:action :controller.:action,@url()无法反向生成——它不支持动态拼接
@url() 参数名必须与路由占位符严格一致
比如路由定义是 GET /hotels/{id} Hotels.Show,@url() 里就得传 "id": 123,不能写 "hotel_id" 或 "ID"。参数值会被自动转字符串,但值里不能含斜线("123/abc" 会导致生成非法 URL,且无报错)。
- 占位符带正则(如
{id})不影响@url()调用方式,只影响正向匹配 - 多个参数按路由顺序传,例如
GET /hotels/:hotel_id/reviews/:review_id Hotels.Review→@url("Hotels.Review", "hotel_id": 1, "review_id": 5) - 路径末尾斜杠行为由路由定义决定:
GET /hotels/ Hotels.Index生成的 URL 必带/hotels/,而GET /hotels Hotels.Index生成的是/hotels
模板中调用 @url() 的常见错误现象
最典型的是链接点击后 404,但控制台和日志里没有任何提示——因为 @url() 在模板渲染阶段就“安静失败”了:找不到匹配路由时,它直接返回空字符串或原始字面量(取决于 Revel 版本),而不是 panic 或 log。
- 检查浏览器源码,看生成的
href是空、是字面量(如href="@url(...)">)、还是明显错误的路径 - 确认
revel run启动时没有报invalid route类警告——有这类警告说明 routes 解析已出问题 - 不要在
@url()里传结构体或 map,只接受扁平键值对;嵌套对象会被忽略
反向路由本质是 routes 文件的静态索引,不是运行时反射。只要 routes 行写对、名字对、参数名对,@url() 就可靠;一旦漏掉命名或拼错一个字母,它就彻底失联,而且不会告诉你哪里错了。











