Django 遷移問題解決指南：刪除或更改重複遷移文件
更新日期： 2024 年 12 月 26 日
本文為 Django migrations 衝突案例探討，第 3 篇：
- 新手指南：如何避免 Django 遷移衝突問題
- 新手指南：如何解決 Django 遷移欄位重複定義的問題
- Django 遷移問題解決指南：刪除或更改重複遷移文件 👈 所在位置
- Django 遷移壓縮（squashmigrations）與手動檢查指南
問題詳解：為何發生重複定義？
在遷移檔案中可以觀察到，freelancer_verified 欄位，已經在初始遷移檔案 0001_initial 中被定義。
然而，後續的遷移檔案 0004_profile_freelancer_verified_profile_is_client_and_more 再次嘗試添加該欄位，導致資料庫執行遷移時報錯，提示該欄位已經存在。
具體錯誤訊息如下：
django.db.utils.ProgrammingError: column "freelancer_verified" of relation "users_profile" already exists為了解決此問題，需要確認是否應刪除 0004 遷移檔案，或者僅修改其中的操作。
以下將逐步說明解決方法。
是否完全刪除 0004 的判斷依據
在確認是否刪除 0004 遷移文件之前，請依以下條件進行判斷：
檢查 0004 是否包含其他有意義的操作
- 刪除條件：如果
0004中除了重複的AddField操作外，沒有其他重要的操作（如新增表或欄位），可以直接刪除整個0004。 - 保留條件：如果
0004中還有其他有意義的操作，請保留這些部分，僅刪除多餘的操作。
檢查依賴關係
刪除 0004 可能影響後續遷移文件（例如 0005）。
請檢查 0005 的 dependencies 是否依賴於 0004。
若有依賴關係，需將 0005 的 dependencies 更新為依賴於上一個有效遷移（如 0003）。
範例如下：
dependencies = [
('users', '0003'), # 更新依賴至 '0003'
]刪除或修改 0004 的具體操作
確認無問題的回滾
在進行任何刪除或修改之前，請先將資料庫狀態回滾到無問題的遷移點。例如：
python manage.py migrate users 0003此操作將撤銷 0004 中的所有更改，確保資料庫結構回到 0003 時的狀態。
修改或刪除 0004
情境 1：直接刪除 0004
- 若
0004中的操作完全多餘（例如，所有欄位已在0001定義），可以直接刪除文件0004_profile_freelancer_verified_profile_is_client_and_more.py。
情境 2：僅刪除重複的操作
- 若
0004中包含其他有意義的操作（如新增其他表或欄位），需保留這些部分並刪除重複的AddField操作。例如，修改0004文件如下：operations = [ # 僅保留非重複操作 ]
更新 0005 的依賴
若刪除了 0004，需更新 0005 的 dependencies。請將其改為依賴於上一個有效遷移（如 0003）：
dependencies = [
('users', '0003'),
]確保後續遷移不再依賴於被刪除的文件。
應用修改後的遷移
完成修改或刪除操作後，重新執行遷移以應用更改：
python manage.py migrate更改遷移文件名稱的影響
若您希望更改遷移文件名稱（例如將 0005 改為 0004），需注意以下影響：
文件名稱的依賴影響
- Django 遷移文件的名稱不僅是文件名，它還與其他遷移文件的
dependencies字段相關聯。直接更改名稱可能導致依賴錯誤。 - 修改文件名稱後，需更新所有依賴於該文件的其他遷移文件。
資料庫的影響
- Django 在資料庫的
django_migrations表中記錄了已執行的遷移文件名稱。更改名稱可能導致資料庫記錄與文件名稱不匹配，從而引發遷移錯誤。
更改名稱的正確步驟
如果希望將 0005 改為 0004，請按以下步驟進行操作：
回滾到無問題的狀態
回滾至最後一個無問題的遷移點（如 0003）：
python manage.py migrate users 0003更改文件名稱
將 0005_alter_profile_freelancer_verified_and_more.py 文件重命名為 0004_alter_profile_freelancer_verified_and_more.py。
更新 dependencies
修改新的 0004 文件中的 dependencies，確保其依賴於上一個有效遷移（如 0003）：
dependencies = [
('users', '0003'),
]更新後續遷移的依賴
若有其他文件依賴於舊 0005，需將其 dependencies 更新為依賴於新的 0004：
dependencies = [
('users', '0004'),
]重新執行遷移
執行遷移以確保所有更改生效：
python manage.py migrate注意事項
資料庫遷移記錄清理
Django 在應用遷移時，會自動更新 django_migrations 表中的記錄，無需手動修改。
確保版本控制一致性
若使用 Git，請確保其他開發者同步這些更改，避免環境不一致。
測試環境驗證
在測試環境中驗證修改後的遷移，特別是在有數據的情況下，避免生產環境出現問題。
總結與建議
直接刪除與更改名稱的比較
| 方法 | 適用情境 | 優勢 |
|---|---|---|
| 直接修改或刪除遷移文件 | 問題發生在開發階段，且資料庫尚未正式部署或共享 | 快速、直接解決問題，適合小規模開發或單人操作。 |
| 更改遷移文件名稱 | 需要重構遷移記錄，或確保遷移順序的連續性 | 適合處理較複雜的遷移記錄，但需謹慎更新所有依賴關係。 |
建議
在開發階段，問題多可通過刪除多餘的遷移文件直接解決。
若需保持遷移記錄的整潔性，可考慮更改文件名稱或壓縮多個遷移文件。