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

✅ 记住：在 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 均支持：

DEFAULT CURRENT_TIMESTAMP
ON UPDATE CURRENT_TIMESTAMP

3.3 MySQL 8.0.13+（现代特性）

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

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

report_date DATE DEFAULT(CURRENT_DATE)
expire_at DATETIME DEFAULT(NOW()+INTERVAL 30 DAY)

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

四、标准建表示例

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

CREATE TABLE user_account (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(64) NOT NULL UNIQUE,
    email VARCHAR(128) NOT NULL,
    -- 创建时间：插入时自动设为当前时间
    create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    -- 更新时间：插入时设为当前时间，每次 UPDATE 自动刷新
    update_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    INDEX idx_update_time (update_time)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户账户表';

✅ 优势：

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

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

CREATE TABLE audit_log (
    id CHAR(36) PRIMARY KEY,
    -- UUID
    event_type VARCHAR(50) NOT NULL,
    payload JSON NOT NULL,
    -- 仅创建时记录，后续永不修改
    create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
) COMMENT='审计日志表';

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

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

CREATE TABLE system_event (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    message TEXT NOT NULL,
    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
) COMMENT='系统事件表';

⚠️ 风险提示：

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

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

-- 仅适用于 MySQL >= 8.0.13
CREATE TABLE daily_summary (
    id INT AUTO_INCREMENT PRIMARY KEY,
    total_orders INT NOT NULL,
    -- 自动设为当前日期（无时间）
    summary_date DATE NOT NULL DEFAULT(CURRENT_DATE),
    -- 完整时间戳
    created_at DATETIME NOT NULL DEFAULT(NOW())
) COMMENT='每日汇总表';

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

五、常见错误

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

错误语句：

create_date DATE DEFAULT current_date NULL COMMENT'创建日期'

原因：

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

修复：

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

错误 2：DEFAULT current_time

错误语句：

create_time DATETIME DEFAULT current_time

原因：

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

修复：

create_time DATETIME DEFAULT CURRENT_TIMESTAMP

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

不规范写法：

create_time DATETIME DEFAULT CURRENT_TIMESTAMP NULL

规范写法：

create_time DATETIME NULL DEFAULT CURRENT_TIMESTAMP
-- 或（更推荐）
create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP

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

六、高级技巧

6.1 微秒精度（MySQL 5.6.4+）

create_time DATETIME(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6),
update_time DATETIME(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6) ON UPDATE CURRENT_TIMESTAMP(6)

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

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

CREATE TABLE log_entry (
    id BIGINT PRIMARY KEY,
    event_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    -- 自动生成日期部分，物理存储
    event_date DATE AS(DATE(event_time)) STORED
);

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

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

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

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

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

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