Django关联Entity与File模型报错：禁止直接赋值多对多反向集合

问题描述 #

关联Entity和File模型时出现模板渲染错误：

Direct assignment to the reverse side of a many-to-many set is prohibited. Use entity_id.set() instead.

同时视图用select_related()或.all()获取数据后，模板始终显示Empty，无数据渲染。

模型关系说明 #

一个Entity对应多个File，每个File仅对应一个Entity。需要将File表的entity_id字段关联到Entity表的entity_id字段（该字段为唯一非主键字段），两张表主键均为自增整数。

现有模型代码 #

class Entity(models.Model):
    pk_entity = models.AutoField(primary_key=True)
    entity_id = models.IntegerField(blank=True, null=True, unique=True)  
    name = models.CharField(blank=True, null=True)
    
    class Meta:
        managed = False
        db_table = 'entities'


class File(models.Model):
    pk_file = models.AutoField(primary_key=True)
    filename = models.CharField(blank=True, null=True)    
    entity_id = models.ForeignKey(Entity, on_delete= models.CASCADE, to_field='entity_id')

现有视图与模板代码 #

视图代码 #

class TestListView(ListView):  
    queryset = File.objects.select_related()    
    template_name = "operations/files/test_list.html"

模板代码 #

{% extends "base.html" %}
{% block content %}
<div>
    <div>       
        <ul>
            {% for x in object_list %}
            <li>             
                {{x}} 
             </li>
            {% empty %}
            <p>Empty</p>
            {% endfor %}
        </ul>      
    </div>
</div>
{% endblock %}

问题分析与解决步骤 #

1. 外键字段命名冲突导致错误 #

你把File模型的外键字段命名为entity_id，这会和Django自动生成的反向关联属性名冲突，导致框架误判为多对多关系。

修复方案：
修改外键字段名，同时指定db_column映射到数据库的entity_id字段，避免命名冲突：

class File(models.Model):
    pk_file = models.AutoField(primary_key=True)
    filename = models.CharField(blank=True, null=True)    
    # 重命名外键字段，指定数据库列名
    entity = models.ForeignKey(Entity, on_delete=models.CASCADE, to_field='entity_id', db_column='entity_id')

2. 规范使用select_related() #

select_related()不传参数时不会关联任何外键，需要明确指定关联字段：

class TestListView(ListView):  
    # 指定关联entity字段，提前加载关联数据
    queryset = File.objects.select_related('entity')    
    template_name = "operations/files/test_list.html"

3. 排查模板无数据渲染问题 #

• 先确认File表是否有数据：在Django Shell中执行print(File.objects.count())查看数据量。
• 给模型添加__str__方法，让模板渲染时显示具体内容（默认{{x}}输出模型的__str__返回值）：

class Entity(models.Model):
    # ... 原有代码
    def __str__(self):
        return f"Entity {self.entity_id}: {self.name}"

class File(models.Model):
    # ... 原有代码
    def __str__(self):
        return f"File {self.filename} (关联Entity: {self.entity.entity_id})"

4. 反向关联的正确使用（可选） #

修改外键字段名后，从Entity实例查询关联File时，默认用file_set：

entity = Entity.objects.get(entity_id=1)
files = entity.file_set.all()

如果想自定义反向关联名称，可在ForeignKey中添加related_name参数：

entity = models.ForeignKey(Entity, on_delete=models.CASCADE, to_field='entity_id', db_column='entity_id', related_name='files')

之后即可用entity.files.all()查询关联文件。

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