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_TIMESTAMP LOCALTIME 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(6) 表示微秒。

DATETIME 和 TIMESTAMP 均支持：

DEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP

3.3 MySQL 8.0.13+（现代特性）

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

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

report_date DATEDEFAULT(CURRENT_DATE) expire_at DATETIMEDEFAULT(NOW()+INTERVAL30DAY)

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

四、标准建表示例

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

CREATETABLE user_account ( id BIGINTUNSIGNEDAUTO_INCREMENTPRIMARYKEY, username VARCHAR(64)NOTNULLUNIQUE, email VARCHAR(128)NOTNULL,-- 创建时间：插入时自动设为当前时间 create_time DATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP,-- 更新时间：插入时设为当前时间，每次 UPDATE 自动刷新 update_time DATETIMENOTNULLDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP,INDEX idx_update_time (update_time))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户账户表';

✅ 优势：

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

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

CREATETABLE audit_log ( id CHAR(36)PRIMARYKEY,-- UUID event_type VARCHAR(50)NOTNULL, payload JSON NOTNULL,-- 仅创建时记录，后续永不修改 create_time DATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP)COMMENT='审计日志表';

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

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

CREATETABLE system_event ( id BIGINTAUTO_INCREMENTPRIMARYKEY, message TEXTNOTNULL, created_at TIMESTAMPNOTNULLDEFAULTCURRENT_TIMESTAMP, updated_at TIMESTAMPNOTNULLDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP)COMMENT='系统事件表';

⚠️ 风险提示：

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

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

-- 仅适用于 MySQL >= 8.0.13CREATETABLE daily_summary ( id INTAUTO_INCREMENTPRIMARYKEY, total_orders INTNOTNULL,-- 自动设为当前日期（无时间） summary_date DATENOTNULLDEFAULT(CURRENT_DATE),-- 完整时间戳 created_at DATETIMENOTNULLDEFAULT(NOW()))COMMENT='每日汇总表';

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

五、常见错误

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

错误语句：

create_date DATEDEFAULTcurrent_dateNULLCOMMENT'创建日期'

原因：

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

修复：

-- 方案A：升级到 8.0.13+ 并加括号 create_date DATEDEFAULT(CURRENT_DATE)-- 方案B：放弃默认值，由应用插入 CURDATE() create_date DATE-- 方案C：改用 DATETIME create_time DATETIMEDEFAULTCURRENT_TIMESTAMP

错误 2：DEFAULT current_time

错误语句：

create_time DATETIMEDEFAULTcurrent_time

原因：

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

修复：

create_time DATETIMEDEFAULTCURRENT_TIMESTAMP

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

不规范写法：

create_time DATETIMEDEFAULTCURRENT_TIMESTAMPNULL

规范写法：

create_time DATETIMENULLDEFAULTCURRENT_TIMESTAMP-- 或（更推荐） create_time DATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP

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

六、高级技巧

6.1 微秒精度（MySQL 5.6.4+）

create_time DATETIME(6)NOTNULLDEFAULTCURRENT_TIMESTAMP(6), update_time DATETIME(6)NOTNULLDEFAULTCURRENT_TIMESTAMP(6)ONUPDATECURRENT_TIMESTAMP(6)

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

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

CREATETABLE log_entry ( id BIGINTPRIMARYKEY, event_time DATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP,-- 自动生成日期部分，物理存储 event_date DATEAS(DATE(event_time)) STORED );

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

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

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

last_modified DATETIMEDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP, synced_at DATETIMEDEFAULTCURRENT_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_date DATEDEFAULT(CURRENT_DATE),-- 2. DATETIME 类型：仍可使用 CURRENT_TIMESTAMP（无需括号，因属历史特例） created_at DATETIMEDEFAULTCURRENT_TIMESTAMP,-- 3. DATETIME 类型：也可用括号形式（推荐统一风格） created_at DATETIMEDEFAULT(NOW()),-- 4. DATETIME 类型：复杂表达式（如 7 天后过期） expire_at DATETIMEDEFAULT(NOW()+INTERVAL7DAY),-- 5. YEAR 类型 fiscal_year YEARDEFAULT(YEAR(CURDATE())),-- 6. 甚至非时间类型 random_code VARCHAR(10)DEFAULT(SUBSTRING(MD5(RAND()),1,10)), initial_score INTDEFAULT(0),

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

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