Go url.URL RequestURI 为什么不包含 Fragment

结论先说：url.URL.RequestURI() 不是完整 URL 的序列化方法，它返回的是 HTTP 请求中使用的请求目标，通常只有编码后的路径和查询字符串。因此，URL 中的 #fragment 不会出现在 RequestURI 结果里；它并没有从 url.URL 对象中消失。

官方文档地址：https://pkg.go.dev/net/url#URL.RequestURI

String 与 RequestURI 处理的对象不同

String() 用来重新组装一个可展示、可保存的完整 URL，可能包含 scheme、host、path、query 和 fragment。RequestURI() 面向 HTTP 请求目标，只取 path?query 或 opaque?query。

用最小示例确认 Fragment 没有丢失

把同一个 URL 分别交给 String() 和 RequestURI()，再直接打印 Fragment 字段，就能看到差异来自方法的用途，而不是解析失败。

package main

import (
    "fmt"
    "log"
    "net/url"
)

func main() {
    // 解析包含路径、查询和片段的完整 URL。
    u, err := url.Parse("https://example.com/docs?lang=zh#install")
    if err != nil {
        // 输入来自配置或用户时，解析失败必须立即停止后续拼接。
        log.Fatal(err)
    }

    // String 用于重组完整地址，所以保留 #install。
    fmt.Println("String:", u.String())
    // RequestURI 只生成 HTTP 请求目标，不携带客户端片段。
    fmt.Println("RequestURI:", u.RequestURI())
    // Fragment 仍然保存在 URL 对象中，可以按应用逻辑单独读取。
    fmt.Println("Fragment:", u.Fragment)
}

输出关系应当是：String 包含 #install，RequestURI 是 /docs?lang=zh，而 Fragment 仍然是 install。这里的关键不是把片段“补回去”，而是根据使用场景选择正确的表示。

为什么 Fragment 不随 HTTP 请求发送

片段通常表示客户端在拿到资源后要定位的局部状态，例如页面锚点或前端路由片段。HTTP 请求目标需要让服务器定位资源和处理查询参数，片段则属于客户端在响应内容上的后续定位信息。

因此，客户端发请求时使用 /docs?lang=zh，而不是把 #install 拼进请求目标。若把完整 URL 直接当成请求目标使用，通常会混淆“可展示地址”和“协议层请求目标”这两个概念。

按场景选择输出方法

还要注意：RequestURI() 不等于给 URL 加上协议和主机。它返回的是请求目标片段；如果要构造完整地址，应保留 String() 的语义。

需要服务端拿到片段时怎么传

如果业务确实需要服务端知道“install”这一信息，就把它作为服务器协议的一部分显式传递，例如查询参数或请求体字段。不要期待服务器从原始 URL 的 Fragment 中自动读取。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    u := &url.URL{Scheme: "https", Host: "example.com", Path: "/docs", Fragment: "install"}

    // 把片段转换为协议字段，服务端才有机会读取这份业务信息。
    query := url.Values{}
    query.Set("section", u.Fragment)
    u.RawQuery = query.Encode()

    // 重新生成请求目标时，section 已经进入 query，Fragment 仍不参与。
    fmt.Println(u.RequestURI())
}

这个例子输出 /docs?section=install。生产代码中还应根据接口约定决定使用 query、JSON body 还是专门的请求头，并对片段内容做长度和字符约束。

常见误区与排查顺序

1. 先确认调用的是 String() 还是 RequestURI()。
2. 再打印 u.Fragment，确认解析对象仍然保留片段。
3. 如果服务端需要该值，检查客户端是否显式把它映射到 query 或 body。
4. 不要通过手写字符串拼接把 # 强行塞进 HTTP 请求目标。

总结

RequestURI() 不包含 Fragment 是预期行为：它服务于 HTTP 请求目标，只返回 path?query 或 opaque?query。完整 URL 展示使用 String()，客户端片段使用 Fragment，需要跨到服务端的片段则必须转换成明确的协议字段。

相关问题

• 为什么 url.URL.String() 会保留 #fragment？因为它重组的是完整 URL。
• 服务端能直接从 RequestURI() 读取 Fragment 吗？不能，除非客户端把片段显式放入 query、body 或其他约定字段。
• Fragment 和 EscapedFragment() 怎么选？前者适合业务语义值，后者用于需要保留 URL 编码形式的场景。