1. 問題背景

在日志中，我們發(fā)現(xiàn)以下錯(cuò)誤：

2025-07-08 15:40:48 [scheduling-1] ERROR o.s.s.s.TaskUtils$LoggingErrorHandler - Unexpected error occurred in scheduled task
org.springframework.dao.DataIntegrityViolationException: 
### Error updating database.  Cause: com.mysql.cj.jdbc.exceptions.MysqlDataTruncation: Data truncation: Data too long for column 'card_number' at row 1

該錯(cuò)誤發(fā)生在向 loc_order_info 表寫入數(shù)據(jù)時(shí)，card_number 字段存儲(chǔ)的數(shù)據(jù)超過了其定義的長(zhǎng)度限制。

1.1 錯(cuò)誤分析

card_number 存儲(chǔ)了多個(gè)卡號(hào)，以逗號(hào)分隔，例如：

163326141751950071490603524,163326141751950071490263532,...

• 20 個(gè)卡號(hào) + 分隔符，總長(zhǎng)度約 500 字符，但 card_number 的 VARCHAR 長(zhǎng)度可能僅為 255 或更小，導(dǎo)致寫入失敗。

2. 解決方案：字段長(zhǎng)度不足（Data too long for column）

2.1 方法1：擴(kuò)大字段長(zhǎng)度（推薦）

ALTER TABLE loc_order_info MODIFY COLUMN card_number VARCHAR(1000);

適用場(chǎng)景：

• 數(shù)據(jù)增長(zhǎng)是合理的，且未來不會(huì)遠(yuǎn)超該長(zhǎng)度。
• 確保該字段沒有索引，否則可能觸發(fā) “Specified key was too long” 錯(cuò)誤（見下文）。

2.2 方法2：優(yōu)化數(shù)據(jù)結(jié)構(gòu)（最佳實(shí)踐）

如果 card_number 存儲(chǔ)的是多個(gè)卡號(hào)，更合理的方式是使用 關(guān)聯(lián)表，例如：

-- 原表
CREATE TABLE loc_order_info (
    id BIGINT PRIMARY KEY,
    order_id VARCHAR(50),
    -- 其他字段...
);

-- 卡號(hào)關(guān)聯(lián)表
CREATE TABLE loc_order_card_numbers (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    order_id BIGINT,
    card_number VARCHAR(50),
    FOREIGN KEY (order_id) REFERENCES loc_order_info(id)
);

優(yōu)點(diǎn)：

• 避免單字段過長(zhǎng)問題。
• 支持更靈活的查詢（如按單個(gè)卡號(hào)搜索）。

2.3 方法3：程序?qū)咏財(cái)啵ㄅR時(shí)方案）

在 Java 代碼中檢查長(zhǎng)度并截?cái)啵?/p>

if (cardNumber.length() > maxLength) {
    cardNumber = cardNumber.substring(0, maxLength);
}

適用場(chǎng)景：

• 臨時(shí)修復(fù)，避免寫入失敗，但可能丟失數(shù)據(jù)。

3. 新問題：索引鍵超限（Specified key was too long）

當(dāng)嘗試擴(kuò)大 VARCHAR(1000) 時(shí)，可能遇到：

Specified key was too long; max key length is 3072 bytes

3.1 原因分析

• MySQL 索引鍵最大長(zhǎng)度：
  • InnoDB 引擎：3072 字節(jié)
  • utf8mb4 字符集（每個(gè)字符占 4 字節(jié)）：1000 × 4 = 4000（超過限制）

3.2 解決方案

方案1：移除或修改索引

-- 查看索引
SHOW INDEX FROM loc_order_info;

-- 移除索引（如非必要）
ALTER TABLE loc_order_info DROP INDEX idx_card_number;

-- 再修改字段
ALTER TABLE loc_order_info MODIFY COLUMN card_number VARCHAR(1000);

方案2：使用前綴索引

ALTER TABLE loc_order_info MODIFY COLUMN card_number VARCHAR(1000);
ALTER TABLE loc_order_info ADD INDEX idx_card_prefix (card_number(191)); -- 前191字符

說明：

• 191 × 4 = 764 字節(jié)（小于 3072）。
• 適合部分匹配查詢（如 LIKE 'ABC%'）。

方案3：調(diào)整字符集（不推薦）

ALTER TABLE loc_order_info MODIFY COLUMN card_number VARCHAR(1000) CHARACTER SET utf8;

缺點(diǎn)：

• utf8 不支持完整的 Unicode（如 emoji）。

4. 高級(jí)查詢：分析長(zhǎng)字段數(shù)據(jù)

4.1 查詢包含逗號(hào)的記錄（按長(zhǎng)度倒序）

SELECT 
    *,
    LENGTH(card_number) AS card_length
FROM loc_card_info 
WHERE card_number LIKE '%,%'
ORDER BY card_length DESC;

4.2 查詢最長(zhǎng)的 N 條記錄

SELECT * 
FROM loc_card_info 
ORDER BY LENGTH(card_number) DESC
LIMIT 10;

4.3 統(tǒng)計(jì)字段長(zhǎng)度分布

SELECT 
    LENGTH(card_number) AS length,
    COUNT(*) AS count
FROM loc_card_info
GROUP BY length
ORDER BY length DESC;

5. 最佳實(shí)踐總結(jié)

6. 結(jié)論

1. 優(yōu)先優(yōu)化數(shù)據(jù)結(jié)構(gòu)，避免單字段存儲(chǔ)多值。
2. 索引長(zhǎng)度需謹(jǐn)慎，超長(zhǎng)字段建議用前綴索引或移除索引。
3. 監(jiān)控字段長(zhǎng)度，定期檢查異常數(shù)據(jù)。

通過合理的數(shù)據(jù)庫(kù)設(shè)計(jì)，可以避免 Data too long 和 Key too long 問題，提升系統(tǒng)穩(wěn)定性。

以上就是MySQL字段長(zhǎng)度與索引限制問題的原因分析及解決方案的詳細(xì)內(nèi)容，更多關(guān)于MySQL字段長(zhǎng)度與索引限制的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！