Django（21）migrate報錯的解決方案

Silent丿丶黑羽發表於2021-05-20
Django

前言

在講解如何解決migrate報錯原因前，我們先要了解migrate做了什麼事情，migrate：將新生成的遷移指令碼。對映到資料庫中。建立新的表或者修改表的結構。
 

問題1：migrate怎麼判斷哪些遷移指令碼需要執行？

它會將程式碼中的遷移指令碼和資料庫中django_migrations中的遷移指令碼進行對比，如果發現資料庫中，沒有這個遷移指令碼，那麼就會執行這個遷移指令碼。
 

問題2：migrate做了什麼事情

  1. 將相關的遷移指令碼翻譯成SQL語句，在資料庫中執行這個SQL語句。
  2. 如果這個SQL語句執行沒有問題，那麼就會將這個遷移指令碼的名字記錄到django_migrations中。
     

實戰案例

當我們瞭解清楚migrate的作用後，我們來看一個案例
首先我們建立一個專案orm_migrations_demo，接著建立2個app應用front和article，程式碼結構如下圖
Django（21）migrate報錯的解決方案
接著在front.models.py和article.models.py中建立模型

# 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，此時資料庫中是沒有表的，因為還沒有執行遷移命令
接著我們執行migrate article，再輸入migrate front，migrate發現資料庫中沒有遷移指令碼，那麼就會執行剛才生成的2個遷移指令碼，將遷移指令碼翻譯成SQL語句，然後建立了2張表，執行完成後，會將遷移指令碼記錄到django_migrations表中，資料庫中表結構如下:
Django（21）migrate報錯的解決方案
django_migrations表中內容如下：
Django（21）migrate報錯的解決方案
接下來我們在article.models.py中新增一個content欄位

class Article(models.Model):
    name = models.CharField(max_length=200)
    content = models.CharField(max_length=200, null=True)

然後執行命令makemigrations article，會在專案中生成遷移檔案0002_article_content.py，接著執行migrate article，執行遷移指令碼，此時資料庫中表django_migrations有3個遷移指令碼
Django（21）migrate報錯的解決方案
 

現在我們來模仿錯誤資訊內容，我們將資料庫中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中的欄位:
Django（21）migrate報錯的解決方案
從上圖中我們可以清楚的看到article表中已經有了content欄位，那麼我們再執行migrate article命令時，就會報錯，說content欄位重複了，報錯資訊如下

django.db.utils.OperationalError: (1060, "Duplicate column name 'content'")

如果發生這種報錯資訊，解決辦法是在migrate命名後新增引數--fake，--fake可以將指定的遷移指令碼名字新增到資料庫中。但是並不會把遷移指令碼轉換為SQL語句去修改資料庫中的表
所以，我們可以執行命名migrate article --fake，會在django_migrations表中插入遷移指令碼記錄0002_article_content，如下圖
Django（21）migrate報錯的解決方案
此時資料庫中表結構和django中的表結構完全一致，接下來執行遷移命令，就不會報錯了
 

第一種報錯情況總結

原因：執行migrate命令會報錯的原因是。資料庫的django_migrations表中的遷移版本記錄和程式碼中的遷移指令碼不一致導致的。
解決辦法：使用--fake引數：首先對比資料庫中的遷移指令碼和程式碼中的遷移指令碼。然後找到哪個不同，之後再使用--fake，將程式碼中的遷移指令碼新增到django_migrations中，但是並不會執行sql語句。這樣就可以避免每次執行migrate的時候，都執行一些重複的遷移指令碼。
 

第二種報錯情況

如果我們不管怎麼執行migrate命令都會報錯，那麼就執行第二種方案

  1. 將出問題的app下的所有模型，都和資料庫中的表保持一致。
  2. 將出問題的app下的所有遷移指令碼檔案都刪掉。再在django_migrations表中將出問題的app相關的遷移記錄都刪掉。
  3. 使用makemigrations，重新將模型生成一個遷移指令碼。
  4. 使用migrate --fake-initial引數，將剛剛生成的遷移指令碼，標記為已經完成（因為這些模型相對應的表，其實都已經在資料庫中存在了，不需要重複執行了。）
  5. 可以做其他的對映了。

相關文章