如何回滚Django中的迁移

当你在Django中运行了迁移，但出现了问题：可能添加了不该有的字段、重命名模型导致数据库混乱，或者只是想回退实验性更改。这时就需要回滚迁移。

掌握如何撤销Django迁移与应用迁移同样重要。这不是关于完美，而是关于快速修复错误而不慌乱。一个错误的迁移可能破坏一切，但好消息是Django提供了安全回退的工具。

Django中的迁移是什么？

在讨论撤销迁移之前，先明确迁移的定义。Django中的迁移是数据库变更的记录，它跟踪你添加或更改的模型，并在后台使用SQL将这些变更应用到实际数据库。

通常使用以下命令创建迁移：

1

python manage.py makemigrations

并这样应用：

1

python manage.py migrate

这时Django会更新数据库表以匹配你的模型。

如何回滚Django迁移

假设你刚运行了迁移并想撤销它。有两种情况：

1. 已应用迁移并想反转它
2. 尚未应用迁移，只想删除它

情况1：撤销已应用的迁移

如果你已经运行了python manage.py migrate，Django已经更改了数据库。

要反转该迁移，使用：

1

python manage.py migrate your_app_name migration_name_before

其中：

• your_app_name是你的Django应用名称（如blog、users或store）
• migration_name_before是你想撤销的迁移之前的迁移名称

示例：假设有一个名为store的应用，有以下迁移：

1
2
3

0001_initial.py  
0002_add_price_to_product.py  
0003_change_price_field.py

要撤销0003_change_price_field.py迁移，运行：

1

python manage.py migrate store 0002

这告诉Django回滚到迁移0002，有效撤销0003中的所有操作。

完成后，你会看到类似输出：

1
2

Operations to reverse:
   - Alter field price on product

你的数据库回到了0003之前的状态。

情况2：撤销尚未应用的迁移

如果你运行了makemigrations但未运行migrate，那么你只是创建了迁移文件，尚未实际触及数据库。

这种情况下，可以安全删除迁移文件。只需进入应用的migrations/文件夹，删除不需要的迁移文件（例如：0003_change_price_field.py）。

然后可以使用正确的更改重新运行makemigrations。

快速提示：除非你知道自己在做什么，否则不要删除__init__.py或0001_initial.py文件。第一个文件通常是必需的。

特殊情况：回滚所有迁移（重置一切）

有时你可能想清除所有迁移并重新开始。这在开发过程中很常见，特别是当数据库结构混乱时。

我通常这样做：

1. 删除应用migrations/文件夹中的迁移文件（除了__init__.py）
2. 删除数据库或清除表（如果使用SQLite或测试数据库）
3. 运行：

1
2

python manage.py makemigrations
python manage.py migrate

如果使用SQLite，也可以直接删除.sqlite3文件并重新开始。

对于PostgreSQL或MySQL，需要删除并重新创建数据库，或使用pgAdmin或DBeaver等工具重置。

示例场景：修复损坏的迁移

假设你向模型添加了新字段：

1
2
3

class Product(models.Model):
    name = models.CharField(max_length=100)
    price = models.DecimalField(max_digits=6, decimal_places=2, default=0.00)

但出现了拼写错误：

1

price = models.DecimalField(max_digits=6, decimal_places=2, default='free')

Django允许你这样做：

1
2

python manage.py makemigrations store
python manage.py migrate

然后它就会出错。

你可以通过回滚来修复：

1

python manage.py migrate store 0001

然后在模型中修复拼写错误并运行：

1
2

python manage.py makemigrations
python manage.py migrate

回到正轨！

常见陷阱（以及如何避免）

• 不要在没有先反转的情况下删除迁移：这会让Django混淆
• 始终检查哪些迁移已应用：使用python manage.py showmigrations
• 备份数据库：尤其是在生产环境中。如果需要，使用pg_dump或mysqldump等工具
• 不要重置实时应用中的迁移：除非绝对必要，否则可能会弄乱生产数据

常见问题解答

可以一次回滚多个迁移吗？

可以！只需迁移到你想要撤销的迁移之前的点。

示例：已应用：

1
2
3
4

[X] 0001_initial  
[X] 0002_add_price_to_product  
[X] 0003_change_price_field  
[X] 0004_add_discount_field

要撤销0004和0003，运行：

1

python manage.py migrate store 0002

这会回滚0004和0003，只保留0001和0002应用。

如何知道使用哪些迁移名称？

运行python manage.py showmigrations，你会看到类似列表：

1
2
3

[X] 0001_initial
[X] 0002_add_price_to_product
[X] 0003_change_price_field

[X]显示已应用的迁移。要撤销0003，迁移回0002。

回滚迁移安全吗？

只要没有对依赖于迁移的数据进行更改，就是安全的。始终在生产环境尝试之前在开发环境中测试。

结论

一旦掌握了技巧，在Django中回滚迁移并不可怕。就像在Word文档中使用撤销功能一样——你只需要知道回退多远。

现在你知道如何在Django中回滚迁移了，你遇到过的最棘手的迁移问题是什么——你是如何解决的？给我发个消息——我很想听听你的故事。

进一步资源

• 官方Django迁移文档
• RealPython的Django迁移入门
• 常见Django错误及如何避免