Django用户资料更新报错：'User'对象无'profile'属性

问题场景 #

作为Django新手，在编写个人资料视图时，为p_form添加instance=request.user.profile参数后，访问/profile页面抛出AttributeError: 'User' object has no attribute 'profile'错误。

相关代码 #

视图代码 #

from django.shortcuts import render, redirect
from django.contrib import messages
from .forms import UserRegisterForm, UserUpdateForm, ProfileUpdateForm
from django.contrib.auth.decorators import login_required


def register(request):
    if request.method == 'POST':
        form = UserRegisterForm(request.POST)
        if form.is_valid():
            form.save()
            username = form.cleaned_data.get('username')
            messages.success(request, f'Account Successfully created for {username}!')
            return redirect('login')
    else:
        form = UserRegisterForm()
    return render(request, 'users/register.html', {'form': form})

@login_required()
def profile(request):
    if request.method == 'POST':
        u_form = UserUpdateForm(request.POST, instance=request.user)
        p_form = ProfileUpdateForm(request.POST, request.FILES, instance=request.user.profile)

        if u_form.is_valid() and p_form.is_valid():
            u_form.save()
            p_form.save()
            messages.success(request, f'Your account has been updated!')
            return redirect('profile')
    else:
        u_form = UserUpdateForm(instance=request.user)
        # 添加instance参数后触发错误
        # p_form = ProfileUpdateForm(instance=request.user.profile)
        p_form = ProfileUpdateForm()

    context = {
        'u_form': u_form,
        'p_form': p_form
    }
    return render(request, 'users/profile.html',context)

错误信息 #

AttributeError at /profile/
'User' object has no attribute 'profile'
Request Method: GET
Request URL:    http://127.0.0.1:8000/profile/
Django Version: 5.2.1
Exception Type: AttributeError
Exception Value:    
'User' object has no attribute 'profile'
Exception Location: D:\Documents\pycharm\venv\Lib\site-packages\django\utils\functional.py, line 253, in inner
Raised during:  users.views.profile

模型代码(models.py) #

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

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    pf_image = models.ImageField(default='default.jpg',upload_to='profile_pics/', null=True, blank=True)

    def __str__(self):
        return f'{self.user.username}Profile'

信号代码(signals.py) #

from django.db.models.signals import post_save
from django.contrib.auth.models import User
from django.dispatch import receiver
from .models import UserProfile

@receiver(post_save, sender=User)
def create_profile(sender, instance, created, **kwargs):
    if created:
        UserProfile.objects.create(user=instance)

@receiver(post_save, sender=User)
def save_profile(sender, instance, **kwargs):
    instance.UserProfile.save()

问题原因与解决步骤 #

1. 修正信号中的反向关联名称错误 #

Django对OneToOneField的反向关联默认使用小写的模型类名，你的信号代码里写的instance.UserProfile.save()是错误的，应该改成小写的userprofile，或者在模型中显式指定关联名称：

方案一：修改信号代码

@receiver(post_save, sender=User)
def save_profile(sender, instance, **kwargs):
    instance.userprofile.save()  # 改成小写的模型类名

方案二：在模型中指定related_name（更推荐）

这样可以直接用request.user.profile访问关联对象：

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='profile')
    pf_image = models.ImageField(default='default.jpg',upload_to='profile_pics/', null=True, blank=True)

    def __str__(self):
        return f'{self.user.username}Profile'

2. 为已有用户补全Profile实例 #

如果数据库里存在在信号生效前创建的用户，这些用户没有对应的UserProfile，需要手动生成：
打开Django Shell执行以下命令：

from django.contrib.auth.models import User
from users.models import UserProfile

for user in User.objects.all():
    UserProfile.objects.get_or_create(user=user)

3. 确保信号被正确加载 #

需要在users/apps.py中导入信号，否则信号不会生效：

from django.apps import AppConfig

class UsersConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'users'

    def ready(self):
        import users.signals

4. 修正视图中的p_form初始化 #

完成以上步骤后，就可以安全地在视图中添加instance参数了：

else:
    u_form = UserUpdateForm(instance=request.user)
    p_form = ProfileUpdateForm(instance=request.user.profile)

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