Gin框架GetQuery无法获取RawQuery中存在的fromDate查询参数如何解决

参数解析失败本质是URL编码不合法导致的标准库解析跳过：传入的查询参数中存在%xxx序列，不符合%后必须跟随2位十六进制字符的URL编码规范，Go标准库net/url的ParseQuery方法遇到非法编码序列时会终止解析对应参数，因此最终解析得到的查询参数map为空，Gin的GetQuery方法依赖该map自然拿不到值，但RawQuery存储的是原始未解析字符串所以内容完整。

提供两种可直接落地的实现方式：

方案1：手动解析RawQuery获取参数值 #

直接处理原始查询字符串拆分提取，完全避开标准库的编码合法性校验，适合需要保留原始参数值做安全校验的场景：

package main

import (
	"fmt"
	"strings"
	"github.com/gin-gonic/gin"
)

// 手动解析原始查询字符串，跳过编码合法性校验
func getRawQueryParam(rawQuery, key string) (string, bool) {
	pairs := strings.Split(rawQuery, "&")
	for _, pair := range pairs {
		kv := strings.SplitN(pair, "=", 2)
		if len(kv) != 2 {
			continue
		}
		if kv[0] == key {
			// 若不需要原始编码值，可自行追加解码逻辑，非法编码部分可选择跳过或保留
			return kv[1], true
		}
	}
	return "", false
}

func main() {
	r := gin.Default()
	r.GET("/", func(c *gin.Context) {
		qParam, ok := getRawQueryParam(c.Request.URL.RawQuery, "fromDate")
		fmt.Println(qParam, ok)
		// 拿到参数后可直接做安全校验，非法请求直接返回错误
		if !ok || strings.Contains(qParam, "extractvalue(") {
			c.JSON(400, gin.H{
				"code": 400,
				"msg": "非法请求参数"
			})
			return
		}
		c.JSON(200, gin.H{
			"message": "pong"
		})
	})
	r.Run("localhost:8181")
}

方案2：预处理后复用标准库解析 #

如果需要保留标准库的URL解码能力，可先对RawQuery做预处理，替换非法编码序列后再解析：

import (
	"net/url"
	"regexp"
)

// 预处理非法编码序列后调用标准库解析
func parseTolerantQuery(rawQuery string) (url.Values, error) {
	// 用正则匹配所有不合法的%序列（%后不是两位十六进制字符），替换为编码后的%25
	re := regexp.MustCompile(`%(?![0-9a-fA-F]{2})`)
	processed := re.ReplaceAllString(rawQuery, "%25")
	return url.ParseQuery(processed)
}

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