MySQL 中 UUID 重复问题分析与 Navicat 误区排查

问题背景

UUID 在理论上应该是全球唯一的，但在 MySQL 中偶尔会出现 UUID 重复的情况。许多开发者会怀疑是否是 Navicat 这样的数据库管理工具导致了问题。

常见原因分析

1. UUID 生成方式问题

   • 使用 MySQL 的 UUID() 函数生成的是版本 1 的 UUID
   • 在某些情况下(如服务器时间回拨)可能导致重复

2. Navicat 显示问题

   • Navicat 可能只是显示工具，不一定是数据重复的根源
   • 网格视图可能因为排序或筛选导致"看起来"重复

3. 应用程序逻辑问题

   • 应用层生成 UUID 的代码可能有缺陷
   • 批量插入时错误地复用了同一个 UUID 值

排查步骤

1. 确认是否真实重复

-- 查询真正重复的 UUID
SELECT uuid_column, COUNT(*) 
FROM your_table 
GROUP BY uuid_column 
HAVING COUNT(*) > 1;

2. 检查 UUID 生成方式

-- 检查 MySQL 版本和 UUID 函数
SELECT VERSION(), UUID();

3. 排除 Navicat 显示问题

• 使用 MySQL 命令行客户端执行相同查询
• 导出数据到 CSV 检查原始数据

4. 检查应用层代码

审查应用程序中生成 UUID 的代码，特别是： - 是否在循环中错误地只生成了一次 UUID - 是否使用了可靠的 UUID 库

解决方案

1. 使用 UUID v4

   -- 如果使用 MySQL 8.0+, 可以使用 UUID_TO_BIN 和随机生成的 UUID
   INSERT INTO your_table (uuid_column) 
   VALUES (UUID_TO_BIN(UUID(), 1));
   

2. 应用层生成 UUID

   • 使用语言内置的 UUID 库(如 Java 的 UUID.randomUUID())
   • 确保每次插入都生成新的 UUID

3. 使用 AUTO_INCREMENT 替代

   ALTER TABLE your_table MODIFY COLUMN id BIGINT AUTO_INCREMENT;
   

4. Navicat 特定检查

   • 更新 Navicat 到最新版本
   • 检查 Navicat 的"首选项"→"记录"设置
   • 尝试禁用 Navicat 的"数据格式化"选项

最佳实践

1. 对于高并发系统，考虑使用雪花算法(Snowflake)等分布式 ID 生成方案
2. 在 MySQL 8.0+ 中使用 UUID_TO_BIN() 和 BIN_TO_UUID() 函数提高存储和查询效率
3. 定期检查表中的 UUID 唯一性约束是否有效

通过以上步骤，您应该能够确定 UUID 重复的真实原因，并排除 Navicat 只是显示问题的可能性。