Gin框架中time.Time参数解析时区错误问题求助

问题重现 #

请求命令：

curl --location 'http://127.0.0.1:5000/v1/search/?from=2023-08-25T17:00:00+03:00'

结构体定义：

type Filters struct {
    From   time.Time `form:"from" binding:"required,gte" time_format:"2006-01-02T15:04:05Z07:00" json:"from"`
}

处理函数：

func Search(c *gin.Context) {
    t := time.Now()
    filters := Filters{}

    if err := c.ShouldBindWith(&filters, binding.Query); err != nil {
        log.Infof("Filter parameter error => %s", err.Error())
        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
        return
    }
    // 后续逻辑
}

收到的错误：

{
    "error": "parsing time \"2023-08-25T17:00:00 03:00\" as \"2006-01-02T15:04:05Z07:00\": cannot parse \" 03:00\" as \"Z07:00\""
}

原因分析 #

错误日志里的"2023-08-25T17:00:00 03:00"已经点明问题：原请求中的+号被HTTP客户端自动转义成了空格。按照URL查询参数规则，+是空格的URL编码形式，curl这类工具会自动解析替换，导致后端收到的时区部分变成空格分隔，和你指定的Z07:00格式（要求时区以Z或±符号开头）不匹配，最终解析失败。

解决方案 #

方案1：转义请求中的+号 #

将请求里的+替换为URL编码%2B，确保后端能收到正确的时区符号：

curl --location 'http://127.0.0.1:5000/v1/search/?from=2023-08-25T17:00:00%2B03:00'

方案2：修改结构体的time_format标签，兼容两种时区格式 #

在time_format中添加空格分隔的时区格式，用|分隔多种兼容格式，这样无论参数是转义前的+还是转义后的空格，都能被正确解析：

type Filters struct {
    From   time.Time `form:"from" binding:"required,gte" time_format:"2006-01-02T15:04:05Z07:00|2006-01-02T15:04:05 -07:00" json:"from"`
}

方案3：简化绑定代码（可选） #

将ShouldBindWith(&filters, binding.Query)替换为ShouldBindQuery(&filters)，功能完全一致，代码更简洁：

if err := c.ShouldBindQuery(&filters); err != nil {
    log.Infof("Filter parameter error => %s", err.Error())
    c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    return
}

验证 #

使用方案1的curl命令，或修改结构体后使用原curl命令，都能成功解析From参数，不再报错。

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