如何避免Django表单上传至数据库的图片路径重复

1. 修正upload_to配置 #

问题根源在于upload_to包含了static/前缀，而STATICFILES_DIRS已经指向项目根目录下的static文件夹，导致数据库存储路径与静态文件查找路径叠加重复。

修改ImageField的upload_to为"img"（仅保留相对于static目录的子路径）：

photo = models.ImageField(
    default="img/Person-595b40b65ba036ed117d315a.svg",  # 默认路径同步调整为相对于static的路径
    upload_to="img",
)

调整后新上传的图片会保存到static/img/目录，数据库仅存储img/images.png，访问时会正确拼接为static/img/images.png。

2. 修复STATICFILES_DIRS配置 #

原配置中同时添加BASE_DIR / "static"和"static/img"属于冗余设置，BASE_DIR / "static"已经包含static/img目录，修改为：

STATIC_URL = "static/"
STATICFILES_DIRS = (
    BASE_DIR / "static",
)

3. 处理已存在的数据库旧路径（无需修改数据库） #

针对数据库中已有的static/img/images.png这类路径，可通过两种方式修正：

方式一：模型中添加属性方法 #

在模型里定义一个属性方法来自动修正路径：

from django.db import models

class YourModel(models.Model):
    photo = models.ImageField(
        default="img/Person-595b40b65ba036ed117d315a.svg",
        upload_to="img",
    )

    @property
    def corrected_photo_url(self):
        if self.photo:
            # 移除路径开头多余的static/前缀
            if self.photo.name.startswith('static/img/'):
                return f"/static/{self.photo.name.replace('static/', '')}"
            return self.photo.url
        return ""

模板中直接使用{{ object.corrected_photo_url }}获取正确URL即可。

方式二：模板内直接处理 #

适合简单场景，在模板中通过过滤器修正路径：

{% if object.photo.name.startswith 'static/img/' %}
    <img src="/static/{{ object.photo.name|cut:'static/' }}" alt="Photo">
{% else %}
    <img src="{{ object.photo.url }}" alt="Photo">
{% endif %}

内容的提问来源于stack exchange，提问作者Алексей Василенко