DRF上传大量相似文件：重复字段模型方案是否适用？

当前这种重复定义license_*和license_*_status字段的方式，仅适合固定数量且几乎不会变动的场景。当需要处理大量相似文件（哪怕当前是5个，未来可能增加数量）时，存在诸多明显弊端：

问题分析 #

• 扩展性极差：如果后续需要支持更多许可证（比如从5个扩展到10个），必须手动新增多组字段，同步修改模型迁移、序列化器、视图逻辑，重复劳动且容易遗漏出错。
• 代码冗余严重：违反DRY（Don't Repeat Yourself）原则，相同的字段配置重复多次，后续要调整存储后端、上传路径或状态选项时，需要修改所有对应字段，维护成本极高。
• 数据操作繁琐：查询或操作文件状态时，无法通过ORM的批量过滤实现，比如要获取用户所有待审核的许可证，得逐个判断license_0_status、license_1_status等字段，代码冗长低效。
• 不符合数据库设计规范：扁平化的存储方式违背关系型数据库的范式设计，相似的实体（许可证）应该作为独立表存储，而非堆砌在同一模型中。

推荐方案：使用一对多关联模型 #

创建独立的License模型与Profile建立一对多关联，结构更清晰，扩展性更强：

修改后的models.py代码 #

@deconstructible
class User_directory_path(object):
    def __init__(self, prefix):
        self.prefix = prefix

    def __call__(self, instance, filename):
        # 基于关联的Profile ID生成存储路径
        return f'{instance.profile.id}/{self.prefix}_{filename}'

class Profile(models.Model):
    id = models.CharField(primary_key=True, max_length=36, default=uuid.uuid4)
    # 保留Profile其他原有字段...

class License(models.Model):
    class DocumentStatus(models.TextChoices):
        NOT_UPLOADED = 'NOT_UPLOADED'
        ON_REVIEW = 'ON_REVIEW'
        ACCEPTED = 'ACCEPTED'

    id = models.CharField(primary_key=True, max_length=36, default=uuid.uuid4)
    # 关联到用户Profile，on_delete可根据业务需求调整
    profile = models.ForeignKey(Profile, on_delete=models.CASCADE, related_name='licenses')
    file = models.FileField(verbose_name='License File',
                            storage=MinioBackend(bucket_name='django-backend-profiles-private', replace_existing=True),
                            upload_to=User_directory_path('license'), max_length=255, null=True, blank=True)
    status = models.CharField(verbose_name='License Status',
                            max_length=15, choices=DocumentStatus.choices, default=DocumentStatus.NOT_UPLOADED)
    order = models.IntegerField(verbose_name='License Order', default=0)  # 标记许可证序号，比如1-5

方案优势 #

• 扩展性强：无需修改模型，直接为用户创建新的License实例即可支持更多许可证；如果需要限制数量，可在视图或信号中添加校验（比如每个用户最多5个）。
• 代码简洁易维护：所有许可证的配置逻辑集中在一处，修改存储、状态等规则只需调整License模型。
• 数据操作高效：通过ORM关联查询可快速处理批量逻辑，比如：
  • 获取用户所有已通过的许可证：profile.licenses.filter(status=License.DocumentStatus.ACCEPTED)
  • 统计待审核许可证数量：profile.licenses.filter(status=License.DocumentStatus.ON_REVIEW).count()
• 符合数据库设计范式：一对多关联清晰，数据结构更合理，便于后续扩展其他属性（比如许可证类型、上传时间等）。

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