Revel模板默认不转义HTML,需手动用{{esc .Var}}防止XSS;esc仅转义、&、"、'五个字符,不适用于属性值、URL等上下文,双重转义和safeHTML均无效。

Revel模板默认不转义,必须手动用esc
Revel的模板引擎和Go标准库html/template相反:它默认**不做任何HTML转义**。这意味着{{.UserName}}会原样输出,如果值是<script>alert(1)</script>,浏览器真会执行。这不是bug,是设计选择——把控制权交给开发者,但也意味着漏掉esc就等于开XSS后门。
正确做法是在每个可能含用户输入的变量后显式加esc:{{esc .Bio}}、{{esc .Comment}}。它等价于html.EscapeString(),只处理、>、&、"、'这5个字符。
- 别指望
{{.Content | safe}}或{{.Content | safeHTML}}——Revel没注册这些函数,写了也无效 - 不要在控制器里提前用
html.EscapeString()再传入模板——这样会导致双重转义(比如&) -
esc只适用于普通HTML文本节点,不适用于属性值、URL、JS等上下文
双引号属性值必须用esc且引号包裹
写@#@#@#@#@#@#@#@#@#@0是危险的,因为.URL若含"或,会提前闭合属性或破坏结构。正确写法是:@#@#@#@#@#@#@#@#@#@1,并确保属性值一定用双引号。
esc会把"转成",把'转成',从而防止属性截断。但注意:esc不校验协议,所以javascript:alert(1)仍会被保留——后端必须在赋值前过滤URL协议,只允许http://、https://、/等白名单。
- 单引号属性(如
title='{{.Text}}')风险更高,esc对'的转义不覆盖十六进制形式(如'),统一用双引号更稳妥 - 不要写
href=https://www.php.cn/link/8627a5992a7f67f8c1e3db85cf9c23eb(没引号),空格或特殊字符会让HTML解析失败
URL和JS上下文不能只靠esc,得在控制器里预处理
esc对href或onclick里的内容只做基础字符转义,不防javascript:伪协议,也不做URL编码。例如{{esc .RedirectURL}}无法阻止javascript:fetch('/api/steal')执行。
安全做法是:在控制器中解析并校验URL,再用url.QueryEscape或template.URL包装(虽然Revel没直接支持template.URL类型,但你可以把校验后的字符串传入模板,再配合esc)。
- 对跳转链接,用
url.Parse()检查Scheme是否在白名单,Host是否为空或合法 - 对内联JS(如
onclick="doSomething({{.ID}})"),绝不能直接插变量;改用data-id="{{esc .ID}}"+ 外部JS读取 - 需要渲染富文本时,用
raw函数({{raw .HTML}})但必须前置用bluemonday过滤,否则等于裸奔
别混淆Revel和html/template的安全机制
很多人把Revel模板和Go标准html/template搞混。后者默认自动转义,导入html/template后写{{.X}}就安全;而Revel是另一套引擎,{{.X}}永远不转义,esc是唯一内置防护手段。
常见错误是照搬html/template经验:比如在Revel里尝试template.HTML类型,或以为{{.X | safeHTML}}有效——这些在Revel中都不起作用。Revel 0.19.0也没提供类似机制,所有转义逻辑必须显式表达在模板中或控制器预处理里。
- 确认你用的是Revel模板,不是自己混入了
html/template实例——两者共存会导致行为不一致 -
raw是不可逆操作,一旦传入未过滤的内容,XSS立即触发,没有“后悔键” - 最易被忽略的点:JSON数据嵌入
<script></script>标签时,Revel不识别JS上下文,esc不够用,必须用json.Marshal序列化后再esc,或改用data-属性传递
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











