八成因ID列存在重复值或NULL值；需先查重复和空值，再确保列定义为NOT NULL，最后添加主键。
ALTER TABLE ADD PRIMARY KEY 会报错的常见原因
直接执行 ALTER TABLE table_name ADD PRIMARY KEY (id) 报错，八成是因为目标列存在重复值或 NULL 值。主键约束要求字段值**非空且唯一**，MySQL 在添加前会校验全表数据，只要有一行不满足，就拒绝操作并抛出类似 Duplicate entry 'X' for key 'PRIMARY' 或 Column 'id' cannot be null 的错误。
- 先查重复：用
SELECT id, COUNT(*) FROM table_name GROUP BY id HAVING COUNT(*) > 1找出重复id - 再查空值：用
SELECT * FROM table_name WHERE id IS NULL检查是否含NULL - 修复方式取决于业务：删重复行、补空值、或用
UPDATE ... SET id = UUID_SHORT()等方式生成唯一值（注意类型兼容性）
给已有表加主键时，INT 类型字段必须显式设为 NOT NULL
即使字段当前没 NULL 值，如果建表时没定义 NOT NULL，ALTER TABLE ... ADD PRIMARY KEY 仍会失败。MySQL 不会自动补上非空约束 —— 它只检查现有数据，不修改列定义。
- 正确顺序是：先
ALTER TABLE table_name MODIFY COLUMN id INT NOT NULL，再ALTER TABLE table_name ADD PRIMARY KEY (id) - 如果字段类型是
VARCHAR，同样要确保已声明NOT NULL，否则MODIFY语句需一并带上NOT NULL - 别依赖“看起来没 NULL 就安全”——表结构定义才是 MySQL 判定依据
联合主键在 ALTER TABLE 中的写法和限制
用 ALTER TABLE ... ADD PRIMARY KEY (col1, col2) 添加联合主键时，MySQL 要求所有参与列都已定义为 NOT NULL，且组合值全局唯一。它不会像单列主键那样允许其中某一列为 NULL（哪怕另一列不为空）。
- 错误示例：
ALTER TABLE orders ADD PRIMARY KEY (user_id, order_time)—— 若order_time允许 NULL，则执行失败 - 必须提前确认：
SHOW COLUMNS FROM orders LIKE 'user_id'和SHOW COLUMNS FROM orders LIKE 'order_time'，确保两列的Null列都显示为NO - 联合主键一旦建立，删除时不能只删其中一个字段，必须用
ALTER TABLE orders DROP PRIMARY KEY整体移除
加完主键后，为什么 INSERT INTO 不指定值却报错？
加主键不等于自动加 AUTO_INCREMENT。很多用户以为设了主键就能省略 id 值，结果遇到 Field 'id' doesn't have a default value。这是两个独立机制：主键保证唯一+非空，自增是额外行为。
- 若想插入时不填
id，得单独加自增：ALTER TABLE table_name MODIFY COLUMN id INT AUTO_INCREMENT - 但注意：该列必须是整数类型，且表中不能有重复值；若已有数据，还需先
ALTER TABLE table_name AUTO_INCREMENT = N设置起始值（N 大于当前最大id） - 更稳妥的做法是建表时就写成
id INT AUTO_INCREMENT PRIMARY KEY，避免后期拆解补丁
主键不是“贴个标签就完事”的操作。它强制触发索引重建、锁表时间变长、还可能暴露历史数据质量问题 —— 加之前务必确认数据洁度，加之后别忘了验证应用层 INSERT 是否适配新约束。
