Go url.URL RawQuery 修改后路径为什么变了怎样构造最小复现

只给同一个 url.URL 的 RawQuery 赋值，不会顺带修改 Path 或 RawPath。若修改查询参数后路径看起来变了，先找附近是否重建了 URL、清空了 RawPath，或把编码后的路径又写进了 Path。尤其是路径里的 %2F，它在解码字段中已经表现为斜杠，丢失编码提示后很容易被误认为 RawQuery 改动造成。

最小可用做法是解析原 URL、复制整个结构体，只用解析后的查询参数生成新 RawQuery。下面按数据从输入、字段保存到字符串输出的关系展开。官方地址：https://pkg.go.dev/net/url。示例只处理内存字符串，不发起请求，也没有本机执行记录。

从原始 URL 保留两种路径表示

原始字符串进入 url.Parse 后，Path 保存解码后的路径，RawPath 是可选的编码提示，RawQuery 保存不带问号的编码查询串。排障时应同时观察 Path、RawPath 和 EscapedPath()，不要仅比较一条完整 URL 日志。

例如本文使用 /archive/report%2F2026：解码后的 Path 是 /archive/report/2026，而编码表示需要保留 %2F，才能描述原串中的那一个编码分隔符。服务器路由如何解释它取决于实际服务，本篇只比较 Go URL 对象与字符串表示。

RawPath 不是必须非空的主字段。需要编码路径时调用 EscapedPath()，让接口判断已有提示是否有效，而不是直接把 RawPath 当作所有 URL 都有的路径。

只替换查询字段并保留错误

package main

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

// withQuery 保留完整 URL 字段，只返回修改后的副本。
func withQuery(src *url.URL, key, value string) (*url.URL, error) {
    if src == nil {
        return nil, errors.New("URL 不能为空")
    }
    if key == "" {
        return nil, errors.New("参数名不能为空")
    }
    q, err := url.ParseQuery(src.RawQuery)
    if err != nil {
        // 不使用解析成功的部分值覆盖原始查询串。
        return nil, fmt.Errorf("解析查询参数: %w", err)
    }
    q.Set(key, value)
    next := *src
    next.RawQuery = q.Encode()
    return &next, nil
}

// show 只打印演示数据，真实日志需要移除敏感查询参数。
func show(label string, u *url.URL) {
    fmt.Printf("%s Path=%q RawPath=%q EscapedPath=%q URL=%q\n",
        label, u.Path, u.RawPath, u.EscapedPath(), u.String())
}

func main() {
    original, err := url.Parse("https://example.com/archive/report%2F2026?sort=old")
    if err != nil {
        log.Fatal(err)
    }
    show("原始", original)
    correct, err := withQuery(original, "sort", "new")
    if err != nil {
        log.Fatal(err)
    }
    show("只改查询", correct)

    // 错误对照一：重建结构体时丢失原来有效的 RawPath。
    rebuilt := &url.URL{
        Scheme: original.Scheme, Host: original.Host,
        Path: original.Path, RawQuery: correct.RawQuery,
    }
    show("丢失编码提示", rebuilt)

    // 错误对照二：把编码后的路径放回要求解码内容的 Path。
    doubled := *correct
    doubled.Path = original.EscapedPath()
    doubled.RawPath = ""
    show("路径二次编码", &doubled)
}

withQuery 是普通查询参数编辑器：它拒绝 nil URL、空参数名和原有查询串的解析错误，允许空值。副本保留了原 URL 的其他字段，查询 map 是本次解析得到的局部数据；函数没有修改 src。

代码特意选择 ParseQuery，而非省略错误的 Query()。原串有错误时，不用部分解析结果继续生成查询串，避免把丢失参数伪装成正常编辑。代码块中的三个对照属于复现材料，不是已经测得的输出。

用三个对照定位编码信息丢失

将完整代码保存为 main.go，读者可在本地执行：

# 仅比较本地 URL 字段与序列化结果，不访问 example.com
go run main.go

表格是根据代码和 API 契约推导的预期，不是实测日志。第一组说明只改查询不需要丢失原编码；第二组证明重建结构体虽然保留了解码路径，却丢掉了编码差异；第三组说明把已编码字符串误当解码路径会再次编码百分号。

String() 读取路径时会通过 EscapedPath() 取得编码形式。若 RawPath 不是 Path 的有效编码，它会被忽略并由 Path 重新计算。因此留下一个旧 RawPath 也不是解决办法：真正改变 Path 后，应重新处理与之对应的编码表示。

查询串重编码与路径变化分开看

RawQuery 的更新也可能改变完整 URL 字符串，但变化不一定在路径。Values.Encode() 会按参数名排序，并以查询编码规则生成值，原来空格的写法、键顺序等可能改变。Set 会把同名参数的值替换为单个值；需要保留多个值时应根据业务使用 Add 或直接维护值列表。

如果业务校验依赖原始查询串的逐字节形式，普通的解析再 Encode 并不是无损编辑。应遵守该业务协议定义的规范化与重新签名规则，不要把本文的查询编辑函数直接当成签名 URL 的透明转发器。

路径片段与查询值也不应共用一套转义逻辑。本文没有对整个 URL 调用 QueryEscape，没有把 ?sort=new 拼到 Path，也没有把完整 URL 当成单个查询值。这些操作会改变字段边界，不能用追加一次解码来补救。

异常输入和共享对象怎样收尾

ForceQuery 可能让空 RawQuery 的 URL 仍然保留末尾问号，这不等于路径多了一个字符。Opaque URL 也有不同的序列化形式；本文使用普通分层 HTTPS 地址，不把其中的结论扩展为所有 URI 都按 Host 与 Path 组合。

返回副本可以减少调用者意外改写原对象的情况，但不构成并发保护。调用期间不能有其他 goroutine 同时修改 src；原对象若共享，应由拥有者负责同步。示例不修改 User 指向的数据，复制结构体并不是对所有潜在引用内容进行深复制的通用承诺。

诊断结束后清理临时完整 URL 日志。查询参数可能含令牌或个人信息，URL.Redacted 也只处理用户信息中的密码，不能替你移除查询串中的秘密。向别人提供复现时，用本文的示例地址与虚构值代替真实业务参数。

只改 RawQuery 以后 Path 字段真的变了怎么办？

把赋值前后观察点挪到同一小函数内，排除额外赋值、对象别名和并发修改。单个字符串字段赋值不会替你执行路径重写。

RawPath 为空是不是 Parse 失败？

不是。RawPath 是可选提示，是否解析失败看返回 error；编码路径应通过 EscapedPath() 获取。

查询参数顺序变了，会影响路由路径吗？

查询串的排序不修改 URL 的路径字段。不过具体应用可能把整个 URL 纳入业务判断或签名，需要另按协议处理。

参考：URL 字段契约、EscapedPath、ParseQuery、Values.Encode。