Django自定义用户模型role字段注册报错：'NoneType'无_inc_path属性

'NoneType' object has no attribute '_inc_path'这个报错看似和文件路径相关，但结合你新增role选择字段后才出现的场景，核心原因大概率是role字段的默认值/表单传递值为空，触发了Wagtail用户创建流程中的隐性逻辑异常，按以下步骤排查解决：

1. 检查CustomUser模型的role字段定义 #

确保字段有合法默认值，或明确允许空值：

from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    ROLE_CHOICES = (
        ('admin', '管理员'),
        ('editor', '编辑'),
        ('viewer', '查看者'),
    )
    # 方案1：设置默认值，确保创建用户时role不为空
    role = models.CharField(max_length=20, choices=ROLE_CHOICES, default='viewer')
    # 方案2：允许空值（需根据业务场景判断是否合理）
    # role = models.CharField(max_length=20, choices=ROLE_CHOICES, null=True, blank=True)

如果模型里既没设默认值也不允许空，表单提交时若role未传值，会导致模型实例创建时role为None，进而触发Wagtail内部的异常。

2. 检查SignUpForm的字段处理 #

如果继承自WagtailUserCreationForm，需确保role字段被正确纳入表单并完成验证：

from wagtail.users.forms import WagtailUserCreationForm
from django import forms

class SignUpForm(WagtailUserCreationForm):
    class Meta(WagtailUserCreationForm.Meta):
        model = CustomUser
        # 将role字段加入表单字段列表
        fields = WagtailUserCreationForm.Meta.fields + ('role',)
    
    # 可选：强制用户选择角色，避免空值提交
    def clean_role(self):
        role = self.cleaned_data.get('role')
        if not role:
            raise forms.ValidationError("请选择用户角色")
        return role

若表单未将role加入fields，前端提交时不会传递该字段值，模型保存时会因字段非空约束报错。

3. 验证前端表单渲染 #

确保模板里正确渲染了role字段的选择控件：

<div class="form-group">
    {{ form.role.label_tag }}
    {{ form.role }}
    {% if form.role.errors %}
        <div class="text-danger">{{ form.role.errors }}</div>
    {% endif %}
</div>

如果前端未渲染该字段，表单提交时不会携带role参数，同样会导致模型创建失败。

4. 排查Wagtail用户创建相关的信号/钩子 #

若你通过信号给不同角色的用户分配权限，需确保信号处理函数不会因role为None报错：

from django.db.models.signals import post_save
from django.dispatch import receiver

@receiver(post_save, sender=CustomUser)
def assign_user_permissions(sender, instance, created, **kwargs):
    if created:
        # 先判断role是否有效，再执行权限分配逻辑
        if instance.role == 'admin':
            # 分配管理员权限逻辑
            pass
        elif instance.role == 'editor':
            # 分配编辑权限逻辑
            pass
        # 避免role为None时触发后续错误

5. 查看完整报错栈定位根源 #

如果以上步骤都无法解决，把完整的报错栈信息贴出来，重点关注_inc_path所属的模块（比如Wagtail的wagtailcore/models.py或其他关联模块），进一步判断是哪个环节因role空值触发了路径相关的异常。

内容的提问来源于stack exchange，提问作者donbonbon