Django一对多关系配置遇FieldError：未知字段project_pictures

在Django项目中实现「项目+多图片」的一对多关联（Project模型包含名称、描述、创建时间、截止日期；Image模型通过外键关联Project，related_name设为project_images），执行python manage.py makemigrations时触发错误：

django.core.exceptions.FieldError: Unknown field(s) (project_pictures) specified for Project

完整错误回溯：

django.core.exceptions.FieldError: Unknown field(s) (project_pictures) specified for Project

full traceback: Exception in thread django-main-thread:
Traceback (most recent call last):
  File "C:\Users\5aitc\AppData\Local\Programs\Python\Python311\Lib\threading.py", line 1038, in _bootstrap_inner
    self.run()
  File "C:\Users\5aitc\AppData\Local\Programs\Python\Python311\Lib\threading.py", line 975, in run
    self._target(*self._args, **self._kwargs)
  File "C:\Django2\env\Lib\site-packages\django\utils\autoreload.py", line 64, in wrapper
    fn(*args, **kwargs)
  File "C:\Django2\env\Lib\site-packages\django\core\management\commands\runserver.py", line 133, in inner_run
    self.check(display_num_errors=True)
  File "C:\Django2\env\Lib\site-packages\django\core\management\base.py", line 485, in check
    all_issues = checks.run_checks(
                 ^^^^^^^^^^^^^^^^^^
  File "C:\Django2\env\Lib\site-packages\django\core\checks\registry.py", line 88, in run_checks
    new_errors = check(app_configs=app_configs, databases=databases)
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Django2\env\Lib\site-packages\django\core\checks\urls.py", line 42, in check_url_namespaces_unique
    all_namespaces = _load_all_namespaces(resolver)
                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Django2\env\Lib\site-packages\django\core\checks\urls.py", line 61, in _load_all_namespaces
    url_patterns = getattr(resolver, "url_patterns", [])
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Django2\env\Lib\site-packages\django\utils\functional.py", line 57, in __get__
    res = instance.__dict__[self.name] = self.func(instance)
                                         ^^^^^^^^^^^^^^^^^^^
  File "C:\Django2\env\Lib\site-packages\django\urls\resolvers.py", line 715, in url_patterns
    patterns = getattr(self.urlconf_module, "urlpatterns", self.urlconf_module)
                       ^^^^^^^^^^^^^^^^^^^
  File "C:\Django2\env\Lib\site-packages\django\utils\functional.py", line 57, in __get__
    res = instance.__dict__[self.name] = self.func(instance)
                                         ^^^^^^^^^^^^^^^^^^^
  File "C:\Django2\env\Lib\site-packages\django\urls\resolvers.py", line 708, in urlconf_module
    return import_module(self.urlconf_name)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\5aitc\AppData\Local\Programs\Python\Python311\Lib\importlib\__init__.py", line 126, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1206, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1178, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1149, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 690, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 940, in exec_module
  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
  File "c:\Django2\Zimmer\zimmer\zimmer\urls.py", line 9, in <module>
    path('', include('projekte.urls')),
             ^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Django2\env\Lib\site-packages\django\urls\conf.py", line 38, in include
    urlconf_module = import_module(urlconf_module)
                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\5aitc\AppData\Local\Programs\Python\Python311\Lib\importlib\__init__.py", line 126, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1206, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1178, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1149, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 690, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 940, in exec_module
  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
  File "c:\Django2\Zimmer\zimmer\projekte\urls.py", line 2, in <module>
    from . import views
  File "c:\Django2\Zimmer\zimmer\projekte\views.py", line 3, in <module>
    from projekte.forms import ProjectForm
  File "c:\Django2\Zimmer\zimmer\projekte\forms.py", line 4, in <module>
    class ProjectForm(forms.ModelForm):
  File "C:\Django2\env\Lib\site-packages\django\forms\models.py", line 321, in __new__
    raise FieldError(message)
django.core.exceptions.FieldError: Unknown field(s) (project_pictures) specified for Project

当前使用的models代码：

from django.db import models

class Project(models.Model):
    project_name = models.CharField(max_length=30)
    project_description = models.CharField(max_length=2000)
    created_at = models.DateTimeField(auto_now_add=True)
    deadline = models.DateTimeField(null=True, blank=True)

    def __str__(self):
        return self.project_name


class Image(models.Model):
    project = models.ForeignKey(Project, on_delete=models.CASCADE, related_name='project_images')
    image = models.ImageField(null=True, blank=True, upload_to="images/")

    def __str__(self):
        return self.image.name

注：此前Project模型包含project_pictures字段，删除该字段后错误仍存在，目标是实现一个项目关联多张图片的功能。

1. 修正ModelForm定义 #

从错误回溯可知，问题出在projekte/forms.py的ProjectForm中——该表单仍在引用已删除的project_pictures字段。
打开forms.py，修改ProjectForm的Meta类，移除project_pictures字段：

from django import forms
from .models import Project

class ProjectForm(forms.ModelForm):
    class Meta:
        model = Project
        # 保留现有Project模型的字段，移除project_pictures
        fields = ['project_name', 'project_description', 'deadline']

2. 清理Django缓存 #

删除项目中所有__pycache__文件夹（每个app目录下及项目根目录的缓存文件夹），避免旧的模型定义被缓存。
若使用Django 4.2及以上版本，可直接执行命令清理缓存：

python manage.py clearcache

3. 重新生成迁移并执行 #

确保模型和表单修改完成后，依次执行：

python manage.py makemigrations
python manage.py migrate

4. 实现多图片上传功能 #

因为图片存储在独立的Image模型中，需用InlineFormSet实现项目与多图片的关联上传：

在视图中定义FormSet #

from django.shortcuts import render, redirect
from django.forms import inlineformset_factory
from .models import Project, Image
from .forms import ProjectForm

def create_project(request):
    # 创建InlineFormSet，关联Project和Image，允许上传3张额外图片
    ImageFormSet = inlineformset_factory(Project, Image, fields=('image',), extra=3)
    
    if request.method == 'POST':
        project_form = ProjectForm(request.POST)
        image_formset = ImageFormSet(request.POST, request.FILES)
        
        if project_form.is_valid() and image_formset.is_valid():
            project = project_form.save()
            # 将表单集关联到新建的项目
            image_formset.instance = project
            image_formset.save()
            return redirect('project_detail', pk=project.pk)
    else:
        project_form = ProjectForm()
        image_formset = ImageFormSet(instance=Project())
    
    return render(request, 'create_project.html', {
        'project_form': project_form,
        'image_formset': image_formset
    })

模板中渲染表单 #

注意表单需设置enctype="multipart/form-data"以支持文件上传：

<form method="post" enctype="multipart/form-data">
    {% csrf_token %}
    {{ project_form.as_p }}
    {{ image_formset.as_p }}
    <button type="submit">创建项目</button>
</form>

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