學過Django的都知道Django使用migrate來做數據庫的更新(在數據庫中執(zhí)行語句),但有些時候我們在使用migrate的時候會遇到一些migrate報錯,那么怎么解決這些migrate報錯呢?接下來這篇文章告訴你。
前言
在講解如何解決migrate
報錯原因前,我們先要了解migrate
做了什么事情,migrate
:將新生成的遷移腳本。映射到數據庫中。創(chuàng)建新的表或者修改表的結構。
問題1:migrate怎么判斷哪些遷移腳本需要執(zhí)行?
它會將代碼中的遷移腳本和數據庫中django_migrations
中的遷移腳本進行對比,如果發(fā)現數據庫中,沒有這個遷移腳本,那么就會執(zhí)行這個遷移腳本。
問題2:migrate做了什么事情
- 將相關的遷移腳本翻譯成SQL語句,在數據庫中執(zhí)行這個SQL語句。
- 如果這個SQL語句執(zhí)行沒有問題,那么就會將這個遷移腳本的名字記錄到
django_migrations
中。
實戰(zhàn)案例
當我們了解清楚migrate
的作用后,我們來看一個案例
首先我們創(chuàng)建一個項目orm_migrations_demo
,接著創(chuàng)建2個app應用front
和article
,代碼結構如下圖
接著在front.models.py
和article.models.py
中創(chuàng)建模型
# front.models.py
class Article(models.Model):
name = models.CharField(max_length=200)
# article.models.py
class FrontUser(models.Model):
name = models.CharField(max_length=200)
接著在settings.py
的INSTALL_APPS
中將app注冊
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'front',
'article',
]
接著我們打開命令行,輸入makemigrations article
,再輸入makemigrations front
,此時2個app目錄中都會出現遷移文件0001_initial.py
,此時數據庫中是沒有表的,因為還沒有執(zhí)行遷移命令
接著我們執(zhí)行migrate article
,再輸入migrate front
,migrate發(fā)現數據庫中沒有遷移腳本,那么就會執(zhí)行剛才生成的2個遷移腳本,將遷移腳本翻譯成SQL語句,然后創(chuàng)建了2張表,執(zhí)行完成后,會將遷移腳本記錄到django_migrations
表中,數據庫中表結構如下:
django_migrations
表中內容如下:
接下來我們在article.models.py
中添加一個content
字段
class Article(models.Model):
name = models.CharField(max_length=200)
content = models.CharField(max_length=200, null=True)
然后執(zhí)行命令makemigrations article
,會在項目中生成遷移文件0002_article_content.py
,接著執(zhí)行migrate article
,執(zhí)行遷移腳本,此時數據庫中表django_migrations
有3個遷移腳本
現在我們來模仿錯誤信息內容,我們將數據庫中django_migrations
表中的0002_article_content
這行記錄刪除,然后我們來看下0002_article_content
的代碼
class Migration(migrations.Migration):
dependencies = [
('article', '0001_initial'),
]
operations = [
migrations.AddField(
model_name='article',
name='content',
field=models.CharField(max_length=200, null=True),
),
]
這個遷移腳本的作用是為article模型添加content
字段,但是我們現在看一下article
中的字段:
從上圖中我們可以清楚的看到article
表中已經有了content
字段,那么我們再執(zhí)行migrate article
命令時,就會報錯,說content字段重復了,報錯信息如下
django.db.utils.OperationalError: (1060, "Duplicate column name 'content'")
如果發(fā)生這種報錯信息,解決辦法是在migrate
命名后添加參數--fake
,--fake
可以將指定的遷移腳本名字添加到數據庫中。但是并不會把遷移腳本轉換為SQL語句去修改數據庫中的表
所以,我們可以執(zhí)行命名migrate article --fake
,會在django_migrations
表中插入遷移腳本記錄0002_article_content
,如下圖
此時數據庫中表結構和django中的表結構完全一致,接下來執(zhí)行遷移命令,就不會報錯了
第一種報錯情況總結
原因:執(zhí)行migrate
命令會報錯的原因是。數據庫的django_migrations
表中的遷移版本記錄和代碼中的遷移腳本不一致導致的。
解決辦法:使用--fake
參數:首先對比數據庫中的遷移腳本和代碼中的遷移腳本。然后找到哪個不同,之后再使用--fake
,將代碼中的遷移腳本添加到django_migrations
中,但是并不會執(zhí)行sql語句。這樣就可以避免每次執(zhí)行migrate
的時候,都執(zhí)行一些重復的遷移腳本。
第二種報錯情況
如果我們不管怎么執(zhí)行migrate
命令都會報錯,那么就執(zhí)行第二種方案
將出問題的app下的所有模型,都和數據庫中的表保持一致。將出問題的app下的所有遷移腳本文件都刪掉。再在django_migrations
表中將出問題的app相關的遷移記錄都刪掉。使用makemigrations
,重新將模型生成一個遷移腳本。使用migrate --fake-initial
參數,將剛剛生成的遷移腳本,標記為已經完成(因為這些模型相對應的表,其實都已經在數據庫中存在了,不需要重復執(zhí)行了。)可以做其他的映射了。
到此這篇Django migrate報錯的解決方案就介紹到這了,更多Django 相關知識請搜索W3Cschool以前的文章或繼續(xù)瀏覽下面的相關文章。