前言

在現(xiàn)代應(yīng)用系統(tǒng)中，記錄數(shù)據(jù)的創(chuàng)建時(shí)間（create_time）和最后修改時(shí)間（update_time）是數(shù)據(jù)庫(kù)設(shè)計(jì)的基本規(guī)范。這類字段不僅用于業(yè)務(wù)邏輯（如“最近更新”排序），更是審計(jì)追蹤、數(shù)據(jù)同步、緩存失效策略的核心依據(jù)。

然而，許多開發(fā)者在實(shí)現(xiàn)這一看似簡(jiǎn)單的功能時(shí)，常因?qū)?MySQL 時(shí)間類型、函數(shù)支持、版本兼容性理解不足而寫出語法錯(cuò)誤或行為異常的 SQL。例如：

• 使用 DEFAULT current_date 導(dǎo)致 [1064] You have an error in your SQL syntax；
• 在 DATE 類型上嘗試設(shè)置動(dòng)態(tài)默認(rèn)值卻在舊版本中失??；
• 混淆 CURRENT_TIME 與 CURRENT_TIMESTAMP；
• 忽略 TIMESTAMP 的時(shí)區(qū)轉(zhuǎn)換特性，引發(fā)數(shù)據(jù)不一致。

一、核心概念：哪些時(shí)間類型支持“當(dāng)前時(shí)間”默認(rèn)值？

MySQL 提供多種時(shí)間相關(guān)數(shù)據(jù)類型，但并非都支持動(dòng)態(tài)默認(rèn)值：

結(jié)論：

• 若需自動(dòng)記錄當(dāng)前時(shí)間，必須使用 DATETIME 或 TIMESTAMP。
• DATE 和 TIME 不適合用于自動(dòng)時(shí)間戳場(chǎng)景（除非明確使用 MySQL 8.0.13+ 的新特性）。

二、唯一合法的默認(rèn)時(shí)間函數(shù)：CURRENT_TIMESTAMP

在 DEFAULT 子句中，只有以下函數(shù)形式被允許：

CURRENT_TIMESTAMP
LOCALTIME
LOCALTIMESTAMP

它們是等價(jià)的，且必須以無參數(shù)形式出現(xiàn)（可帶精度，如 CURRENT_TIMESTAMP(6)）。

常見非法寫法（會(huì)導(dǎo)致 1064 錯(cuò)誤）：

記住：在 DEFAULT 中，只認(rèn) CURRENT_TIMESTAMP。

三、MySQL 版本演進(jìn)

3.1 MySQL 5.6.5 之前（已淘汰）

• 僅 TIMESTAMP 支持自動(dòng)初始化/更新。
• 一個(gè)表最多只能有一個(gè) TIMESTAMP 字段帶 DEFAULT CURRENT_TIMESTAMP。
• DATETIME 完全不支持函數(shù)默認(rèn)值。

3.2 MySQL 5.6.5 ~ 8.0.12（主流穩(wěn)定版本）

• DATETIME 和 TIMESTAMP 均支持：

DEFAULT CURRENT_TIMESTAMP
ON UPDATE CURRENT_TIMESTAMP

• 可定義多個(gè)自動(dòng)時(shí)間字段。
• 精度支持：DATETIME(6) 表示微秒。

3.3 MySQL 8.0.13+（現(xiàn)代特性）

• 引入 函數(shù)默認(rèn)值（Functional Default Values）：

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

• 必須加括號(hào) ( )，否則語法錯(cuò)誤。

建議：除非你 100% 確定生產(chǎn)環(huán)境為 8.0.13+，否則不要依賴 DATE 的函數(shù)默認(rèn)值。

四、標(biāo)準(zhǔn)建表示例

示例 1：基礎(chǔ)自動(dòng)時(shí)間字段（兼容 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,

    -- 創(chuàng)建時(shí)間：插入時(shí)自動(dòng)設(shè)為當(dāng)前時(shí)間
    create_time   DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,

    -- 更新時(shí)間：插入時(shí)設(shè)為當(dāng)前時(shí)間，每次 UPDATE 自動(dòng)刷新
    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='用戶賬戶表';

? 優(yōu)勢(shì)：

• 兼容性強(qiáng)（MySQL 5.6.5+ 均支持）；
• 無需應(yīng)用層干預(yù)；
• 語義清晰，符合行業(yè)慣例。

示例 2：僅記錄創(chuàng)建時(shí)間（不可變）

CREATE TABLE audit_log (
    id          CHAR(36) PRIMARY KEY,  -- UUID
    event_type  VARCHAR(50) NOT NULL,
    payload     JSON NOT NULL,

    -- 僅創(chuàng)建時(shí)記錄，后續(xù)永不修改
    create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
) COMMENT='審計(jì)日志表';

?? 注意：若需確保 create_time 不被意外更新，可在應(yīng)用層禁止修改，或通過觸發(fā)器保護(hù)。

示例 3：使用 TIMESTAMP（謹(jǐn)慎選擇）

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='系統(tǒng)事件表';

?? 風(fēng)險(xiǎn)提示：

• TIMESTAMP 存儲(chǔ)為 UTC，查詢時(shí)根據(jù) time_zone 會(huì)話變量轉(zhuǎn)換；
• 如果應(yīng)用服務(wù)器時(shí)區(qū)不統(tǒng)一，可能導(dǎo)致數(shù)據(jù)混亂；
• 推薦：統(tǒng)一使用 DATETIME + 應(yīng)用層處理時(shí)區(qū)（如始終存 UTC 時(shí)間）。

示例 4：MySQL 8.0.13+：為 DATE 設(shè)置默認(rèn)當(dāng)前日期

-- 僅適用于 MySQL >= 8.0.13
CREATE TABLE daily_summary (
    id           INT AUTO_INCREMENT PRIMARY KEY,
    total_orders INT NOT NULL,

    -- 自動(dòng)設(shè)為當(dāng)前日期（無時(shí)間）
    summary_date DATE NOT NULL DEFAULT (CURRENT_DATE),

    -- 完整時(shí)間戳
    created_at   DATETIME NOT NULL DEFAULT (NOW())
) COMMENT='每日匯總表';

關(guān)鍵：必須使用 括號(hào) (CURRENT_DATE)，這是函數(shù)默認(rèn)值的語法要求。

五、常見錯(cuò)誤

錯(cuò)誤 1：[1064] near 'current_date null comment ...'

錯(cuò)誤語句：

create_date DATE DEFAULT current_date NULL COMMENT '創(chuàng)建日期'

原因：

1. current_date 是保留關(guān)鍵字，未轉(zhuǎn)義（雖非主因）；
2. 更關(guān)鍵的是：在大多數(shù) MySQL 版本中，DATE 類型不支持 CURRENT_DATE 作為默認(rèn)值；
3. 即使支持（8.0.13+），也必須寫成 (CURRENT_DATE)。

修復(fù)：

-- 方案A：升級(jí)到 8.0.13+ 并加括號(hào)
create_date DATE DEFAULT (CURRENT_DATE)

-- 方案B：放棄默認(rèn)值，由應(yīng)用插入 CURDATE()
create_date DATE

-- 方案C：改用 DATETIME
create_time DATETIME DEFAULT CURRENT_TIMESTAMP

錯(cuò)誤 2：DEFAULT current_time

錯(cuò)誤語句：

create_time DATETIME DEFAULT current_time

原因：

• CURRENT_TIME 返回 TIME 類型（如 14:30:00），不能賦值給 DATETIME；
• 且 CURRENT_TIME 不是合法的默認(rèn)值函數(shù)。

修復(fù)：

create_time DATETIME DEFAULT CURRENT_TIMESTAMP

錯(cuò)誤 3：混淆NULL與默認(rèn)值順序

不規(guī)范寫法：

create_time DATETIME DEFAULT CURRENT_TIMESTAMP NULL

規(guī)范寫法：

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

?? 時(shí)間字段通常不應(yīng)為 NULL，建議設(shè)為 NOT NULL。

六、高級(jí)技巧

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 位微秒精度；
• 適用于高并發(fā)、需要精確排序的場(chǎng)景。

6.2 生成列派生日期（避免 DATE 默認(rèn)值問題）

CREATE TABLE log_entry (
    id          BIGINT PRIMARY KEY,
    event_time  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,

    -- 自動(dòng)生成日期部分，物理存儲(chǔ)
    event_date  DATE AS (DATE(event_time)) STORED
);

• 兼容 MySQL 5.7+；
• 查詢 event_date 無需函數(shù)計(jì)算，可建索引。

6.3 多個(gè)自動(dòng)更新字段（MySQL 5.7+）

雖然一個(gè)表通常只需一個(gè) update_time，但技術(shù)上可定義多個(gè)：

last_modified DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
synced_at     DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP

但業(yè)務(wù)上應(yīng)避免冗余。

七、最佳實(shí)踐

補(bǔ)充說明：MySQL 8.0.13+ 的“函數(shù)默認(rèn)值”（Functional Default Values）

從 MySQL 8.0.13 開始，官方引入了 WL#12593: Functional key parts and functional default values，其中一項(xiàng)重大改進(jìn)是：

允許在任何列類型上使用“標(biāo)量表達(dá)式”作為默認(rèn)值，只要該表達(dá)式滿足確定性、無副作用、不依賴子查詢或用戶變量等條件。

這意味著：

• 不再局限于 CURRENT_TIMESTAMP 這一特例；
• DATE、DATETIME、INT、VARCHAR 等類型均可使用括號(hào)包裹的函數(shù)或表達(dá)式作為默認(rèn)值；
• 必須使用括號(hào) ( ) 顯式聲明這是一個(gè)表達(dá)式，這是語法強(qiáng)制要求。

支持的典型時(shí)間類表達(dá)式示例（MySQL ≥ 8.0.13）：

-- 1. DATE 類型：默認(rèn)當(dāng)前日期
report_date DATE DEFAULT (CURRENT_DATE),

-- 2. DATETIME 類型：仍可使用 CURRENT_TIMESTAMP（無需括號(hào)，因?qū)贇v史特例）
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,

-- 3. DATETIME 類型：也可用括號(hào)形式（推薦統(tǒng)一風(fēng)格）
created_at DATETIME DEFAULT (NOW()),

-- 4. DATETIME 類型：復(fù)雜表達(dá)式（如 7 天后過期）
expire_at DATETIME DEFAULT (NOW() + INTERVAL 7 DAY),

-- 5. YEAR 類型
fiscal_year YEAR DEFAULT (YEAR(CURDATE())),

-- 6. 甚至非時(shí)間類型
random_code VARCHAR(10) DEFAULT (SUBSTRING(MD5(RAND()), 1, 10)),
initial_score INT DEFAULT (0),

重要區(qū)別：帶括號(hào) vs 不帶括號(hào)

結(jié)論：

• 在 8.0.13+ 中，DATETIME 字段既可以繼續(xù)使用傳統(tǒng)的 DEFAULT CURRENT_TIMESTAMP（無括號(hào)），也可以使用新式的 DEFAULT (NOW())；
• 而 DATE 字段只能通過 DEFAULT (CURRENT_DATE) 實(shí)現(xiàn)自動(dòng)默認(rèn)值；
• 括號(hào)是新語法的標(biāo)志，缺失則被視為普通標(biāo)識(shí)符或非法函數(shù)調(diào)用。

以上就是MySQL為時(shí)間字段設(shè)置默認(rèn)當(dāng)前時(shí)間的方法技巧的詳細(xì)內(nèi)容，更多關(guān)于MySQL為時(shí)間字段設(shè)置當(dāng)前時(shí)間的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論