在Go中读取MySQL Date类型，一不小心就踩坑

一不小心就踩坑

先举一个实际的🌰：

我们先创建一个表，并插入一行数据。注意表中两个字段一个是DATETIME类型，一个是DATE类型的

sql 复制代码

CREATE TABLE `t_test` (
  `id` int NOT NULL AUTO_INCREMENT,
  `f_one` datetime DEFAULT NULL,
  `f_two` date DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

INSERT INTO `test`.`t_test` (`f_one`, `f_two`) VALUES ('2025-11-29 10:25:05', '2025-11-29');

当我们查询数据可以看到和插入的数据一致

f_one datetime展示为2025-11-29 10:25:05
f_two date展示为2025-11-29

shell 复制代码

mysql> select * from t_test where id = 1;
+----+---------------------+------------+
| id | f_one               | f_two      |
+----+---------------------+------------+
|  1 | 2025-11-29 10:25:05 | 2025-11-29 |
+----+---------------------+------------+
1 row in set (0.003 sec)

现在使用Go来读取上面的数据

go 复制代码

package main

import (
	"testing"

	"github.com/stretchr/testify/assert"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)

type Test struct {
	ID   int    `gorm:"column:id;primaryKey"`
	FOne string `gorm:"column:f_one"` // 注意这里我们定义成了string类型
	FTwo string `gorm:"column:f_two"` // 注意这里我们定义成了string类型
}

func (t Test) TableName() string {
	return "t_test"
}

func TestRead(t *testing.T) {
	// 数据库连接配置
	dsn := "root:root@tcp(127.0.0.1:3306)/test?charset=utf8mb4&parseTime=True&loc=Local"

	db, err := gorm.Open(mysql.Open(dsn))
	assert.Nil(t, err)

	var result Test
	err = db.Where("id = ?", 1).Find(&result).Error
	assert.Nil(t, err)

	assert.Equal(t, "2025-11-29 10:25:05", result.FOne)
	assert.Equal(t, "2025-11-29", result.FTwo)
}

可以在这里暂停思考下，上面的单元测试是否会通过。下面是实际执行的结果。

shell 复制代码

Error: Not equal: 
       expected: "2025-11-29 10:25:05"
       actual  : "2025-11-29T10:25:05+08:00"

Error: Not equal: 
       expected: "2025-11-29"
       actual  : "2025-11-29T00:00:00+08:00"

结果非常Amazing啊

f_one我们期望的是2025-11-29 10:25:05，实际Go读取到是 2025-11-29T10:25:05+08:00，额外添加了T分隔符和时区信息

f_two我们期望的是2025-11-29，实际Go读取到是 2025-11-29T00:00:00+08:00，不仅额外添加了T分隔符和时区信息，还添加了时分秒

你看，如果你对Go读取到字符串按MySQL时间格式处理，可能一不注意就踩坑里了。

问题出在哪里？

你可能已经注意到了，Go结构体的定义使用了string类型，但不知道你有没有注意到数据库连接中的另外一个参数parseTime=True。

parseTime是什么？parseTime是 Go 的 MySQL 驱动 (github.com/go-sql-driver/mysql) 中的一个连接参数，控制是否将 MySQL 时间类型自动转换为 Go 的 time.Time对象：

parseTime=false 禁用自动转换（默认值）
parseTime=true 启用自动转换

当Go的定义为string类型时，问题就出在自动转换上

parseTime=false时，转化方式为DATETIME/DATE(MySQL)->string(Go) ，不会出现上面的问题，Go中读取到的字符串和MySQL的格式一致：2025-11-29 10:25:05和2025-11-29

parseTime=true时，Go的MySQL驱动首先尝试将 MySQL的 DATETIME/DATE(MySQL)解析为 Go 的 time.Time对象，当发现目标字段是 string类型时，驱动会自动调用 time.Time的 String()方法进行转换，time.String()按照RFC3339格式输出，与MySQL中展示的格式不一致，就形成了上文的效果。也就是说

go 复制代码

# 开启parseTime=true且Go类型定义为string时

`DATETIME(MySQL)` 
      |
      v
`time.Time`(golang) 
      |
      | ->这里的`time.time`到`string`这一步出现了转化差异
      v
`string(golang)`

总结

下面总结不同parseTime和Go类型定义的情况下，Go程序读取到的值。

Go字段类型定义	parseTime=false	parseTime=true
`string`	`YYYY-MM-DD[ HH:MM:SS[.fraction]]` 即： `DATE`->`YYYY-MM-DD` `DATETIME`->`YYYY-MM-DD HH:MM:SS` `DATETIME(3)`->`YYYY-MM-DD HH:MM:SS.sss` `DATETIME(6)`->`YYYY-MM-DD HH:MM:SS.ssssss` 零值->`0000-00-00[ 00:00:00]` 此时Go中时间字符串的格式和MySQL默认格式一致	RFC3339 `YYYY-MM-DDTHH:MM:SS±HH:MM` 此时Go中时间字符串的格式和MySQL默认格式不一致！！
`time.Time`	报错 (类型不兼容)	Go`time.Time`实例如果零值也是零值`time.Time`实例

由此也引出了比较合理的使用姿势

如果启用了parseTime=true，我建议你在Go中定义成time.Time类型

go 复制代码

type Test struct {
	ID   int       `gorm:"column:id;primaryKey"`
	FOne time.Time `gorm:"column:f_one"`
	FTwo time.Time `gorm:"column:f_two"`
}

如果没有启用，即parseTime=false，在Go只能定义成string

go 复制代码

type Test struct {
	ID   int    `gorm:"column:id;primaryKey"`
	FOne string `gorm:"column:f_one"`
	FTwo string `gorm:"column:f_two"`
}

✨ 微信公众号【凉凉的知识库】同步更新，欢迎关注获取最新最有用的知识 ✨