Golang中html.Parse渲染href时&被转义为&的问题及解决

为什么&会被转成&？ #

这是HTML规范的强制要求：属性值中的&属于特殊字符，必须转义为&，否则浏览器可能会将其误认为HTML实体的起始标记，导致页面解析错误。html.Render函数严格遵循HTML标准，因此会自动对属性内的特殊字符做转义处理，确保输出的HTML具备合法性。

如何避免该行为？ #

直接使用html.Render无法跳过转义，但可以通过自定义渲染器，针对特定属性实现不转义逻辑。以下是针对a标签href属性的示例代码：

package main

import (
    "os"
    "strings"

    "golang.org/x/net/html"
    "golang.org/x/net/html/atom"
)

type noEscapeRenderer struct{}

func (r *noEscapeRenderer) RenderNode(w html.Writer, n *html.Node) error {
    switch n.Type {
    case html.ElementNode:
        if n.DataAtom == atom.A {
            // 手动输出a标签，跳过href属性的转义
            w.WriteString("<a")
            for _, attr := range n.Attr {
                w.WriteString(" ")
                w.WriteString(attr.Key)
                w.WriteString(`="`)
                if attr.Key == "href" {
                    // 直接输出原始URL，不转义
                    w.WriteString(attr.Val)
                } else {
                    // 其他属性保持默认转义逻辑
                    html.Escape(w, []byte(attr.Val))
                }
                w.WriteString(`"`)
            }
            w.WriteString(">")
            // 递归渲染子节点
            for c := n.FirstChild; c != nil; c = c.NextSibling {
                if err := r.RenderNode(w, c); err != nil {
                    return err
                }
            }
            w.WriteString("</a>")
            return nil
        }
        // 其他标签使用默认渲染逻辑
        return html.Render(w, n)
    default:
        // 文本节点、注释等使用默认渲染
        return html.Render(w, n)
    }
}

func main() {
    myHtmlDocument := `&lt;!DOCTYPE html&gt;
&lt;html&gt;
&lt;head&gt;
&lt;/head&gt;
&lt;body&gt;
    &lt;a href=&quot;http://www.example.com/input?foo=bar&amp;baz=quux&quot;&gt;WTF&lt;/a&gt;
&lt;/body&gt;
&lt;/html&gt;`

    doc, _ := html.Parse(strings.NewReader(myHtmlDocument))
    renderer := &noEscapeRenderer{}
    renderer.RenderNode(os.Stdout, doc)
}

注意事项 #

该方案仅针对a标签的href属性跳过转义，其他标签和属性仍遵循HTML规范进行转义。需要注意的是，不转义&会让HTML不符合严格规范，虽然主流浏览器通常能正确解析，但如果URL中包含<、>等其他需要转义的特殊字符，可能会引发解析问题，仅建议在URL仅包含&作为参数分隔符的场景下使用。

内容的提问来源于stack exchange，提问作者tmountain