MySQL 中为时间字段设置默认当前时间

前言

在现代应用系统中，记录数据的创建时间（create_time）和最后修改时间（update_time）是数据库设计的基本规范。这类字段不仅用于业务逻辑（如“最近更新”排序），更是审计追踪、数据同步、缓存失效策略的核心依据。

然而，许多开发者在实现这一看似简单的功能时，常因对 MySQL 时间类型、函数支持、版本兼容性理解不足而写出语法错误或行为异常的 SQL。例如：

• 使用DEFAULT current_date导致[1064] You have an error in your SQL syntax；
• 在DATE类型上尝试设置动态默认值却在旧版本中失败；
• 混淆CURRENT_TIME与CURRENT_TIMESTAMP；
• 忽略TIMESTAMP的时区转换特性，引发数据不一致。

一、核心概念：哪些时间类型支持“当前时间”默认值？

MySQL 提供多种时间相关数据类型，但并非都支持动态默认值：

📌结论：

• 若需自动记录当前时间，必须使用DATETIME或TIMESTAMP。
• DATE和TIME不适合用于自动时间戳场景（除非明确使用 MySQL 8.0.13+ 的新特性）。

二、唯一合法的默认时间函数：CURRENT_TIMESTAMP

在DEFAULT子句中，只有以下函数形式被允许：

CURRENT_TIMESTAMPLOCALTIME LOCALTIMESTAMP

它们是等价的，且必须以无参数形式出现（可带精度，如CURRENT_TIMESTAMP(6)）。

⚠️ 常见非法写法（会导致 1064 错误）：

✅记住：在DEFAULT中，只认CURRENT_TIMESTAMP。

三、MySQL 版本演进

3.1 MySQL 5.6.5 之前（已淘汰）

• 仅TIMESTAMP支持自动初始化/更新。
• 一个表最多只能有一个TIMESTAMP字段带DEFAULT CURRENT_TIMESTAMP。
• DATETIME完全不支持函数默认值。

3.2 MySQL 5.6.5 ~ 8.0.12（主流稳定版本）

• DATETIME和TIMESTAMP均支持：

  DEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP

• 可定义多个自动时间字段。
• 精度支持：DATETIME(6)表示微秒。

3.3 MySQL 8.0.13+（现代特性）

• 引入函数默认值（Functional Default Values）：

  report_dateDATEDEFAULT(CURRENT_DATE)expire_atDATETIMEDEFAULT(NOW()+INTERVAL30DAY)

• 必须加括号( )，否则语法错误。

💡建议：除非你 100% 确定生产环境为 8.0.13+，否则不要依赖DATE的函数默认值。

四、标准建表示例

示例 1：基础自动时间字段（兼容 5.6.5+）

CREATETABLEuser_account(idBIGINTUNSIGNEDAUTO_INCREMENTPRIMARYKEY,usernameVARCHAR(64)NOTNULLUNIQUE,emailVARCHAR(128)NOTNULL,-- 创建时间：插入时自动设为当前时间create_timeDATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP,-- 更新时间：插入时设为当前时间，每次 UPDATE 自动刷新update_timeDATETIMENOTNULLDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP,INDEXidx_update_time(update_time))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4COLLATE=utf8mb4_unicode_ciCOMMENT='用户账户表';

✅优势：

• 兼容性强（MySQL 5.6.5+ 均支持）；
• 无需应用层干预；
• 语义清晰，符合行业惯例。

示例 2：仅记录创建时间（不可变）

CREATETABLEaudit_log(idCHAR(36)PRIMARYKEY,-- UUIDevent_typeVARCHAR(50)NOTNULL,payload JSONNOTNULL,-- 仅创建时记录，后续永不修改create_timeDATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP)COMMENT='审计日志表';

🔒 注意：若需确保create_time不被意外更新，可在应用层禁止修改，或通过触发器保护。

示例 3：使用 TIMESTAMP（谨慎选择）

CREATETABLEsystem_event(idBIGINTAUTO_INCREMENTPRIMARYKEY,messageTEXTNOTNULL,created_atTIMESTAMPNOTNULLDEFAULTCURRENT_TIMESTAMP,updated_atTIMESTAMPNOTNULLDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP)COMMENT='系统事件表';

⚠️风险提示：

• TIMESTAMP存储为 UTC，查询时根据time_zone会话变量转换；
• 如果应用服务器时区不统一，可能导致数据混乱；
• 推荐：统一使用DATETIME+ 应用层处理时区（如始终存 UTC 时间）。

示例 4：MySQL 8.0.13+：为 DATE 设置默认当前日期

-- 仅适用于 MySQL >= 8.0.13CREATETABLEdaily_summary(idINTAUTO_INCREMENTPRIMARYKEY,total_ordersINTNOTNULL,-- 自动设为当前日期（无时间）summary_dateDATENOTNULLDEFAULT(CURRENT_DATE),-- 完整时间戳created_atDATETIMENOTNULLDEFAULT(NOW()))COMMENT='每日汇总表';

🔑关键：必须使用括号(CURRENT_DATE)，这是函数默认值的语法要求。

五、常见错误

错误 1：[1064] near 'current_date null comment ...'

错误语句：

create_dateDATEDEFAULTcurrent_dateNULLCOMMENT'创建日期'

原因：

1. current_date是保留关键字，未转义（虽非主因）；
2. 更关键的是：在大多数 MySQL 版本中，DATE类型不支持CURRENT_DATE作为默认值；
3. 即使支持（8.0.13+），也必须写成(CURRENT_DATE)。

修复：

-- 方案A：升级到 8.0.13+ 并加括号create_dateDATEDEFAULT(CURRENT_DATE)-- 方案B：放弃默认值，由应用插入 CURDATE()create_dateDATE-- 方案C：改用 DATETIMEcreate_timeDATETIMEDEFAULTCURRENT_TIMESTAMP

错误 2：DEFAULT current_time

错误语句：

create_timeDATETIMEDEFAULTcurrent_time

原因：

• CURRENT_TIME返回TIME类型（如14:30:00），不能赋值给DATETIME；
• 且CURRENT_TIME不是合法的默认值函数。

修复：

create_timeDATETIMEDEFAULTCURRENT_TIMESTAMP

错误 3：混淆NULL与默认值顺序

不规范写法：

create_timeDATETIMEDEFAULTCURRENT_TIMESTAMPNULL

规范写法：

create_timeDATETIMENULLDEFAULTCURRENT_TIMESTAMP-- 或（更推荐）create_timeDATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP

💡 时间字段通常不应为NULL，建议设为NOT NULL。

六、高级技巧

6.1 微秒精度（MySQL 5.6.4+）

create_timeDATETIME(6)NOTNULLDEFAULTCURRENT_TIMESTAMP(6),update_timeDATETIME(6)NOTNULLDEFAULTCURRENT_TIMESTAMP(6)ONUPDATECURRENT_TIMESTAMP(6)

• (6)表示 6 位微秒精度；
• 适用于高并发、需要精确排序的场景。

6.2 生成列派生日期（避免 DATE 默认值问题）

CREATETABLElog_entry(idBIGINTPRIMARYKEY,event_timeDATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP,-- 自动生成日期部分，物理存储event_dateDATEAS(DATE(event_time))STORED);

• 兼容 MySQL 5.7+；
• 查询event_date无需函数计算，可建索引。

6.3 多个自动更新字段（MySQL 5.7+）

虽然一个表通常只需一个update_time，但技术上可定义多个：

last_modifiedDATETIMEDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP,synced_atDATETIMEDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP

⚠️ 但业务上应避免冗余。

七、最佳实践

🔧 补充说明：MySQL 8.0.13+ 的“函数默认值”（Functional Default Values）

从MySQL 8.0.13 开始，官方引入了 WL#12593: Functional key parts and functional default values，其中一项重大改进是：

允许在任何列类型上使用“标量表达式”作为默认值，只要该表达式满足确定性、无副作用、不依赖子查询或用户变量等条件。

这意味着：

• 不再局限于CURRENT_TIMESTAMP这一特例；
• DATE、DATETIME、INT、VARCHAR等类型均可使用括号包裹的函数或表达式作为默认值；
• 必须使用括号( )显式声明这是一个表达式，这是语法强制要求。

✅ 支持的典型时间类表达式示例（MySQL ≥ 8.0.13）：

-- 1. DATE 类型：默认当前日期report_dateDATEDEFAULT(CURRENT_DATE),-- 2. DATETIME 类型：仍可使用 CURRENT_TIMESTAMP（无需括号，因属历史特例）created_atDATETIMEDEFAULTCURRENT_TIMESTAMP,-- 3. DATETIME 类型：也可用括号形式（推荐统一风格）created_atDATETIMEDEFAULT(NOW()),-- 4. DATETIME 类型：复杂表达式（如 7 天后过期）expire_atDATETIMEDEFAULT(NOW()+INTERVAL7DAY),-- 5. YEAR 类型fiscal_yearYEARDEFAULT(YEAR(CURDATE())),-- 6. 甚至非时间类型random_codeVARCHAR(10)DEFAULT(SUBSTRING(MD5(RAND()),1,10)),initial_scoreINTDEFAULT(0),

⚠️ 重要区别：带括号 vs 不带括号

📌结论：

• 在8.0.13+中，DATETIME字段既可以继续使用传统的DEFAULT CURRENT_TIMESTAMP（无括号），也可以使用新式的DEFAULT (NOW())；
• 而DATE字段只能通过DEFAULT (CURRENT_DATE)实现自动默认值；
• 括号是新语法的标志，缺失则被视为普通标识符或非法函数调用。