Django项目创建员工时实例已保存但图片未存储的解决方法

以下是排查和解决的具体步骤：

1. 检查HTML表单的enctype属性 #

上传文件的表单必须添加enctype="multipart/form-data"，否则文件无法被后端接收。在你的emp_crt.html模板中，确保form标签格式如下：

<form method="POST" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">添加员工</button>
</form>

2. 配置Django媒体文件参数 #

在项目的settings.py中补充媒体文件相关配置：

import os

# 媒体文件存储的根目录
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
# 媒体文件的访问URL前缀
MEDIA_URL = '/media/'

注：你Model中upload_to='static/image/emp'会让文件存在MEDIA_ROOT/static/image/emp路径下，若想简化路径，可将upload_to改为'emp/'，文件会直接存在media/emp目录下，更符合Django规范。

3. 开发环境配置媒体文件路由 #

在项目主urls.py中添加媒体文件的访问路由，确保开发服务器能正确提供媒体文件：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的其他路由配置
    path('emp/add/', views.EmpAdd, name='emp_add'),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

4. 安装Pillow依赖库 #

Django的ImageField依赖Pillow处理图片，未安装会导致图片无法存储，执行以下命令安装：

pip install pillow

5. 调试验证文件接收状态 #

可以在View中添加调试打印，确认文件是否被正确传递和保存：

def EmpAdd(request):
    if request.method=='POST':
        print(request.FILES)  # 打印上传的文件列表，查看是否包含emp_photo
        form=EmpForm(request.POST,request.FILES)
        if form.is_valid():
            emp = form.save()
            print(emp.emp_photo)  # 打印保存后的图片路径，确认是否有值
            messages.success(request,'New Employee has been added')
        else:
            print(form.errors)  # 打印表单错误信息，排查验证问题
            messages.error(request,'There has been error')
    else:
        form=EmpForm()

    return render(request,'emp/emp_crt.html',{'form':form})

按上述步骤逐一排查，即可解决图片无法存储的问题。

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