自定义继承AbstractUser User模型Django3.0.6+xadmin2.0.1添加用户报错
问题本质
报错的核心是xadmin在渲染用户新增表单的过程中,对未入库、没有主键ID的空User实例,提前触发了多对多关联字段的访问。
继承AbstractUser的User模型,天然携带groups、user_permissions两个多对多字段,这类字段的关联管理器初始化,强制要求所属实例已经在数据库中拥有有效主键ID,否则就会抛出日志末尾的ValueError。
为什么换了版本就报错,之前正常?
- 旧环境(Django1.11.11 + xadmin0.6.1)的表单渲染逻辑,会自动识别当前实例的入库状态,新增页面的空实例会跳过对多对多字段的属性访问,完全不会触碰到关联管理器的初始化流程,因此不会报错
- 新环境(Django3.0.6 + xadmin2.0.1)的xadmin版本本身对高版本Django的适配存在缺陷,在新增页面渲染时,会遍历模型元数据里的所有字段尝试提取值做展示,哪怕是尚未保存的空实例,也会强行访问多对多字段的关联管理器,直接触发报错。
你自定义的
mobile字段本身没有任何问题,整个报错链路中没有涉及对这个字段的校验或访问,不需要调整模型定义。
可行的解决方案
- 调整xadmin中User模型的注册配置,绕开新增页面的多对多字段渲染
在注册User模型的xadmin配置类里,重写新增页面的表单布局,把groups、user_permissions两个多对多字段从自动渲染的列表中移除,等用户保存完实例、进入编辑页面后再加载相关字段,示例代码:class UserAdmin(object): def get_form_layout(self): # 识别当前为新增页面,无已保存的实例 if self.org_obj is None: self.form_layout = ( Main( Fieldset( "", "username", "mobile", "password1", "password2", css_class="unsort no_title" ) ) ) return super().get_form_layout() - 给xadmin打兼容补丁,修复字段查找逻辑
在项目的初始化阶段(比如对应App的ready()方法、项目根路由文件),对xadmin的字段查找方法做补丁:当检测到无主键的空实例访问多对多字段时,直接返回空值,不触发关联管理器初始化,示例代码:from xadmin import util from django.db.models import ManyToManyField # 保留原方法的引用 original_lookup_field = util.lookup_field def patched_lookup_field(obj, field_name, *args, **kwargs): # 空实例访问多对多字段时直接返回空,跳过关联初始化 if not getattr(obj, "pk", None): field_map = {f.name: f for f in obj._meta.get_fields()} if field_name in field_map and isinstance(field_map[field_name], ManyToManyField): return [] return original_lookup_field(obj, field_name, *args, **kwargs) # 替换xadmin内部的字段查找方法 util.lookup_field = patched_lookup_field - 更换适配版本
xadmin2.0.1早已停止官方维护,对Django3.x的适配存在大量遗留问题,可以切换为社区持续维护、适配Django3.x全系列的xadmin分支版本,从根源上减少这类兼容报错。
内容的提问来源于stack exchange,提问作者hhao
相关产品推荐
相关产品推荐

