Go url.URL 的 ForceQuery 怎样保留空查询问号-Golang学习网

在 Go 里，https://example.com/items? 和 https://example.com/items 的查询参数都为空，但它们保留了不同的原始写法。直接看 RawQuery 很容易把这两个 URL 当成同一种状态。

解决办法是把 url.URL.ForceQuery 当作“原始 URL 是否出现过问号”的独立标记：RawQuery 为空时，将 ForceQuery 设为 true，URL.String() 才会保留末尾的 ?。

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

先看懂 ForceQuery 的三种状态

URL 结构体把编码后的查询内容放在 RawQuery，把“原始地址是否有问号”放在 ForceQuery。两者组合后，才能还原查询部分的三种常见状态。

语义	RawQuery	ForceQuery	String 输出
没有查询	空	false	`/items`
空查询	空	true	`/items?`
带参数查询	`page=2`	通常不重要	`/items?page=2`

对比没有查询、空查询和带参数查询时 RawQuery、ForceQuery 与 String 输出的关系 — 图1：三个 URL 状态对应不同的 RawQuery 与 ForceQuery 组合；这是静态说明图，不是运行截图。

最小配方：解析后保留结尾问号

如果输入来自请求行、代理配置或签名原文，优先让 url.Parse 识别原始字符串，而不是先拆掉问号再拼接。解析结果会保留空查询的状态，重新输出时即可得到原来的形式。

package main

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

func main() {
	// 这三个输入只在查询部分的写法上不同。
	inputs := []string{
		"https://example.com/items",
		"https://example.com/items?",
		"https://example.com/items?page=2",
	}

	for _, raw := range inputs {
		u, err := url.Parse(raw)
		if err != nil {
			// 解析失败时停止，避免把不完整 URL 当成签名或请求目标。
			log.Fatal(err)
		}
		// RawQuery 表示查询内容，ForceQuery 表示原文是否出现过问号。
		fmt.Printf("raw=%q query=%q force=%v out=%q\\n", raw, u.RawQuery, u.ForceQuery, u.String())
	}
}

关键点是：空查询时 RawQuery == "" 是正常现象，不能据此判断原始字符串没有 ?。要保留这个差别，应读取 ForceQuery。

修改查询参数时，先决定是否还要空查询

业务代码经常需要先读出参数、修改值，再通过 Values.Encode 写回 RawQuery。一旦写入了参数，问号会由非空的 RawQuery 自然产生；如果删除完参数仍要保留问号，则需要显式保留 ForceQuery。

package main

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

func rewrite(raw string, keepEmptyQuery bool) (string, error) {
	u, err := url.Parse(raw)
	if err != nil {
		return "", err
	}

	// 先保存原始状态，再把查询解析成可修改的 Values。
	wantedEmptyQuery := keepEmptyQuery && u.ForceQuery
	values := u.Query()
	values.Del("page")
	u.RawQuery = values.Encode()
	// 删除参数后 RawQuery 可能为空，此时由策略决定是否保留问号。
	u.ForceQuery = wantedEmptyQuery && u.RawQuery == ""
	return u.String(), nil
}

func main() {
	result, err := rewrite("https://example.com/items?page=2", true)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(result)
}

这个配方把“删除参数”和“是否保留空查询”拆成两个决策。不要无条件把 ForceQuery 设为 true，否则原本没有查询的 URL 也会被改写成带问号的形式。

关键字段与输出方法怎么选

URL.Query() 适合读取参数，它返回解码后的 url.Values；Values.Encode() 再把参数编码回查询文本。RawQuery 适合保存编码后的查询部分，不能把它当成包含开头问号的完整字符串。

展示 url.Parse、Query、Values.Encode、RawQuery、ForceQuery、String 和 RequestURI 的字段流转 — 图2：从解析到输出请求目标的字段流转，重点标出 ForceQuery 只负责保留问号的边界；这是静态结构图，不是运行截图。

目标	建议调用	注意事项
得到完整 URL 文本	`u.String()`	会根据字段组合输出 `?` 和 `#fragment`
得到 HTTP 请求目标	`u.RequestURI()`	只适合请求目标，不包含 scheme 和 host
读取参数值	`u.Query()`	空查询和无查询都得到空的 Values
保留编码后的查询	`u.RawQuery`	不包含开头的问号，修改后要保证编码正确

package main

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

func main() {
	u, err := url.Parse("https://example.com/items?")
	if err != nil {
		log.Fatal(err)
	}

	// Query 只关心参数集合，因此空查询和无查询都会表现为空。
	fmt.Printf("values=%v rawQuery=%q forceQuery=%v\\n", u.Query(), u.RawQuery, u.ForceQuery)
	// String 保留完整 URL 的查询标记，RequestURI 只返回请求目标部分。
	fmt.Printf("string=%q requestURI=%q\\n", u.String(), u.RequestURI())
}