MySQL添加自增主键前须确保无主键且字段值唯一，否则报错；建议先检查主键、处理重复数据（8.0用ROW_NUMBER()，5.7建新表填充），再执行ALTER TABLE；注意外键、锁表及AUTO_INCREMENT起始值设置时机。
ALTER TABLE 添加自增主键前必须确保无主键且字段值唯一
MySQL 不允许直接对已有数据的表执行 ALTER TABLE ... ADD COLUMN id INT AUTO_INCREMENT PRIMARY KEY FIRST，除非该列当前为空、无重复值、且表原本没有主键。否则会报错 ERROR 1075: Incorrect table definition; there can be only one auto column and it must be defined as a key 或 ERROR 1062: Duplicate entry 'X' for key 'PRIMARY'。
实操建议：
- 先检查是否已有主键：
SHOW CREATE TABLE your_table; - 确认待设为自增的字段（比如新
id）当前为空或可安全填充——若已有数据，需先用UPDATE补全、或用ALTER TABLE ... ADD COLUMN id INT FIRST加普通列再赋值 - 若原表有重复值（如靠业务字段模拟主键），必须先去重或加约束过滤，否则
AUTO_INCREMENT无法启用
处理重复数据：用 ROW_NUMBER() 模拟序号再写入（MySQL 8.0+）
MySQL 8.0 支持窗口函数，可安全为现有行生成唯一序号，避免手动 SET @i:=@i+1 在多线程下错乱。
实操步骤：
- 添加临时列：
ALTER TABLE your_table ADD COLUMN tmp_id BIGINT; - 用
ROW_NUMBER()填充（按某列排序保证稳定）：UPDATE your_table t1 JOIN ( SELECT id, ROW_NUMBER() OVER (ORDER BY created_at, name) AS rn FROM your_table ) t2 ON t1.id = t2.id SET t1.tmp_id = t2.rn;
- 删掉旧主键列（如有）、改名：
ALTER TABLE your_table DROP PRIMARY KEY, DROP COLUMN id, CHANGE tmp_id id BIGINT AUTO_INCREMENT PRIMARY KEY FIRST;
MySQL 5.7 及以下：用变量 + ORDER BY 实现可控编号
低版本不支持窗口函数，但 ORDER BY 在 UPDATE ... JOIN 中不可靠，稳妥做法是先用变量生成中间结果表，再替换。
实操建议：
- 建临时表并灌入带序号的数据：
CREATE TABLE your_table_new LIKE your_table; ALTER TABLE your_table_new ADD COLUMN id BIGINT AUTO_INCREMENT PRIMARY KEY FIRST; INSERT INTO your_table_new (col1, col2, ...) SELECT col1, col2, ... FROM your_table ORDER BY created_at, id;
- 校验数据量一致：
SELECT COUNT(*) FROM your_table; SELECT COUNT(*) FROM your_table_new; - 原子替换：
RENAME TABLE your_table TO your_table_bak, your_table_new TO your_table;
AUTO_INCREMENT 初始值与性能影响
新增自增主键后，INSERT 性能通常提升（聚簇索引更紧凑），但要注意默认起始值是 1，若数据里最大 id 是 999，下次插入会从 1000 开始——这本身没问题；但如果你手动 INSERT ... VALUES (1234, ...)，MySQL 会接受，并把 AUTO_INCREMENT 计数器更新为 MAX(id)+1，后续自增仍延续，不会冲突。
容易被忽略的点：
-
ALTER TABLE ... AUTO_INCREMENT = N必须在设置主键之后单独执行，不能合并进同一语句 - 如果表有外键引用，必须先删外键约束，加完主键再重建，否则报错
ERROR 1833: Cannot change column 'id': used in a foreign key constraint - 大表执行
ALTER TABLE会锁表（尤其 5.7 默认使用 copy-alter），务必在低峰期操作，或用pt-online-schema-change替代
