在使用Django开发Web应用时，图片上传与展示是许多项目（如博客、电商、社交平台）的核心需求。尽管Django提供了强大的文件处理机制，但不少开发者在实际部署过程中常遇到“文件未找到”或404错误的问题。这不仅影响用户体验，也容易让人陷入调试困境。本文将从零开始，系统梳理Django图片上传与显示的完整流程，并针对常见的“文件未找到”问题提供精准解决方案。

首先，确保模型中正确使用ImageField或FileField来存储图片路径。以一个简单的用户头像模型为例：

python
from django.db import models

class UserProfile(models.Model):
name = models.CharField(maxlength=100) avatar = models.ImageField(uploadto='avatars/', blank=True, null=True)

def __str__(self):
    return self.name

这里的upload_to参数决定了图片上传后在服务器上的相对路径。上传的文件不会直接存入数据库，而是保存在指定目录中，数据库仅记录文件路径。

接下来是关键的配置环节。在项目的settings.py中，必须显式设置媒体文件的根目录和URL前缀：

python
import os

MEDIAURL = '/media/' MEDIAROOT = os.path.join(BASE_DIR, 'media')

MEDIA_ROOT是文件系统中的物理路径，而MEDIA_URL是浏览器访问这些文件所使用的URL前缀。两者缺一不可。

配置完成后，需要在主urls.py中启用媒体文件的URL路由。这一点在开发阶段尤其重要，因为Django仅在DEBUG = True时自动提供对媒体文件的访问支持。添加如下代码：

python
from django.conf import settings
from django.conf.urls.static import static
from django.urls import path
from myapp import views

urlpatterns = [
path('', views.index, name='index'),
]

if settings.DEBUG:
urlpatterns += static(settings.MEDIAURL, documentroot=settings.MEDIA_ROOT)

若忽略此步骤，即使文件已成功上传，浏览器也无法通过URL访问，从而导致“文件未找到”错误。

表单处理同样不容忽视。上传图片需使用enctype="multipart/form-data"的HTML表单，并在视图中正确处理request.FILES。例如，在基于函数的视图中：

python def upload_avatar(request): if request.method == 'POST': form = ProfileForm(request.POST, request.FILES) if form.is_valid(): form.save() return redirect('success') else: form = ProfileForm() return render(request, 'upload.html', {'form': form})

模板中应确保表单编码类型正确：

html

当图片成功上传后，前端展示时需使用{{ object.avatar.url }}而非直接拼接路径。例如：

html {% if profile.avatar %} <img src="{{ profile.avatar.url }}" alt="头像"> {% else %} <p>暂无头像</p> {% endif %}

此时若仍出现404错误，应优先检查以下几点：
1. MEDIA_URL是否以斜杠开头且与URL路由一致；
2. MEDIA_ROOT目录是否存在并具有写权限；
3. 是否在开发环境中启用了static()辅助函数；
4. 上传的文件是否真实存在于服务器对应路径下。

在生产环境中，通常由Nginx或Apache等Web服务器处理媒体文件请求，不再依赖Django。因此需配置服务器反向代理规则，例如Nginx中添加：

nginx location /media/ { alias /path/to/your/project/media/; }

总结而言，Django图片功能出错的根本原因多源于路径配置缺失或不一致。只要理清MEDIA_ROOT、MEDIA_URL与URL路由三者的关系，并在开发与生产环境分别做好适配，就能彻底避免“文件未找到”的尴尬局面。掌握这一流程，不仅能提升开发效率，也为后续的文件管理打下坚实基础。