如何在迁移脚本中安全修改ENUM列值？添加或删除枚举项

添加新枚举项（避免覆盖原有值） #

你遇到的问题是因为每次修改ENUM时只指定了部分值，导致原有枚举项被覆盖。要保留原有值同时添加新项，有两种可靠方式：

1. 手动保留所有原有值 #

每次修改时，必须把所有已存在的枚举值全部写进去，再追加新值。比如第一次添加orange：

ALTER TABLE example MODIFY COLUMN fruit ENUM("apple", "banana", "orange") NOT NULL;

后续添加peach时，要包含之前的所有枚举项：

ALTER TABLE example MODIFY COLUMN fruit ENUM("apple", "banana", "orange", "peach") NOT NULL;

如果怕遗漏原有值，可以先查询当前列的定义：

SELECT COLUMN_TYPE FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_SCHEMA = '你的数据库名' 
AND TABLE_NAME = 'example' 
AND COLUMN_NAME = 'fruit';

执行后会返回类似enum('apple','banana')的结果，直接拿来拼接即可。

2. 使用MySQL 8.0.19+的新增语法 #

如果你的MySQL版本是8.0.19及以上，支持直接添加枚举值，无需重写所有原有项：

-- 添加单个新值
ALTER TABLE example MODIFY COLUMN fruit ENUM("apple", "banana") NOT NULL ADD VALUE 'orange';
-- 继续添加新值
ALTER TABLE example MODIFY COLUMN fruit ENUM("apple", "banana", "orange") NOT NULL ADD VALUE 'peach';

这种方式更简洁，也不会误删原有枚举项。

移除旧枚举项（谨慎操作） #

移除枚举项风险较高，若表中已有使用该值的记录，直接移除会导致数据异常（非NULL列会报错，允许NULL的列会被设为NULL）。安全操作步骤如下：

1. 先检查是否有使用目标枚举值的记录：

SELECT COUNT(*) FROM example WHERE fruit = '要移除的值';

2. 如果存在相关记录，先将这些数据更新为其他合法枚举值：

UPDATE example SET fruit = 'apple' WHERE fruit = 'banana';

3. 再修改ENUM定义移除目标项（需保留所有需要的枚举值）：

ALTER TABLE example MODIFY COLUMN fruit ENUM("apple", "orange", "peach") NOT NULL;

MySQL 8.0.19+也支持直接删除枚举值：

ALTER TABLE example MODIFY COLUMN fruit ENUM("apple", "banana", "orange", "peach") NOT NULL DROP VALUE 'banana';

注意事项 #

• 大表操作尽量选业务低峰期，MySQL 5.6+可添加ALGORITHM=INPLACE, LOCK=NONE减少锁表影响：

ALTER TABLE example MODIFY COLUMN fruit ENUM("apple", "banana", "orange") NOT NULL ALGORITHM=INPLACE, LOCK=NONE;

• 所有操作先在测试环境验证，确认无误再部署到生产环境。
• 如果需要频繁修改枚举值，建议改用关联表存储选项，比ENUM类型更灵活。

内容的提问来源于stack exchange，提问作者tttpapi