一、問題現象分析

咱們在用Django開發時，有時候需要擴展用戶模型，就會去繼承AbstractUser。但這么做的時候，要是沒處理好groups和user_permissions這兩個多對多字段的反向查詢名稱，就會遇到這樣的報錯：

主要就是這種錯誤：

ERRORS:
auth.User.groups: (fields.E304) Reverse accessor clashes...
HINT: Add or change a related_name argument...

說白了，問題出在哪呢？就是Django自帶的auth.User模型和咱們自己寫的users.User模型，都有同名的多對多字段，結果導致反向查詢名稱（也就是related_name）打架了。

二、解決方案

1. 顯式聲明沖突字段
咱們得在自定義用戶模型里重新定義一下groups和user_permissions字段，給它們起個獨特的名字（也就是設置related_name參數）：

# users/models.py
from django.contrib.auth.models import AbstractUser, Group, Permissionclass User(AbstractUser):# 這些是咱們新增的字段，保持不變就行mobile = models.CharField(...)avatar = models.ImageField(...)# 關鍵修復的地方：重新定義多對多字段groups = models.ManyToManyField(Group,verbose_name='用戶組',blank=True,related_name="custom_user_groups",  # 給它起個獨特的名字related_query_name="user",)user_permissions = models.ManyToManyField(Permission,verbose_name='用戶權限',blank=True,related_name="custom_user_permissions",  # 這個也想起個獨特的名字related_query_name="user",)

2. 配置驗證
別忘了在settings.py里告訴Django咱們用的是自定義模型：

AUTH_USER_MODEL = 'users.User'  # 這里得對應你的app名和模型名

這一步非常關鍵，因為它告訴Django整個框架應該使用你的自定義用戶模型，而不是默認的auth.User模型，確保認證系統、權限管理和其他依賴用戶模型的功能都能正常工作。

3. 執行數據庫遷移

最后，執行這兩條命令讓改動生效：

python manage.py makemigrations
python manage.py migrate

三、原理解讀

1. 沖突機制
Django的權限系統是靠groups和user_permissions這兩個字段來實現多對多關聯的。當咱們自定義的模型繼承AbstractUser時，要是沒重新定義這兩個字段，它們的related_name就會和Django內置的auth.User模型的默認值（通常是user_set）撞車，導致命名沖突。

2. related_name作用
這個參數其實就是給反向查詢起個別名。比如說，通過user.groups可以查到用戶屬于哪些組，反過來，通過Group.custom_user_groups也能查到這個組里有哪些用戶。這個別名必須在整個項目里是唯一的，不然就會打架。

3. 字段重寫必要性
Django比較"耿直"，它不會自動為繼承的字段生成新的related_name，所以咱們必須手動重新聲明這兩個字段，并給它們指定一個獨特的related_name參數。