Django Admin 图片上传错误：“提交的文件为空” 解决方案-Python教程-PHP中文网

Django Admin 图片上传错误：“提交的文件为空” 解决方案

碧海醫心

发布： 2025-10-19 12:14:32

原创

913人浏览过

django admin 图片上传错误：“提交的文件为空” 解决方案

本文针对 Django admin 后台图片上传时出现“提交的文件为空”的错误，提供详细的排查和解决方案。重点在于避免与 Django 内部逻辑冲突，确保 Pillow 库已安装，以及正确配置静态文件和媒体文件路径。通过本文，您将能够快速定位问题并解决，顺利实现图片上传功能。

在使用 Django admin 后台上传图片时，可能会遇到 "Submitted file is empty" 的错误。这通常表示 Django 无法正确接收或处理上传的图片文件。以下是一些常见的导致此问题的原因以及相应的解决方案：

1. 避免命名冲突

Django 内部使用一些特定的名称来构建其逻辑。如果你在项目中使用与 Django 内部名称冲突的模块名（例如，将你的 app 命名为 auth 或 auths），可能会导致一些难以预料的问题。

解决方案:

检查并修改目录名/文件名: 确保你的项目目录和文件名没有与 Django 内部使用的名称冲突。例如，避免在 static 目录下创建一个名为 media 的目录。尝试将该目录重命名为其他名称，例如 media_files。

2. 确认 Pillow 库已安装

Django 的 ImageField 依赖于 Pillow 库来处理图片。如果 Pillow 未安装，Django 将无法正确处理上传的图片。

解决方案:

安装 Pillow: 使用 pip 安装 Pillow 库。
```
pip install Pillow
```
登录后复制

3. 静态文件和媒体文件配置

Django 需要正确配置静态文件和媒体文件的路径才能正确提供和处理这些文件。

解决方案:

检查 settings.py 文件: 确保 settings.py 文件中已正确配置 MEDIA_URL 和 MEDIA_ROOT。

Cutout老照片上色
Cutout.Pro推出的黑白图片上色

20

查看详情
```
import os

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
```
登录后复制
MEDIA_URL 是浏览器访问媒体文件的 URL 前缀。MEDIA_ROOT 是服务器上存储媒体文件的实际路径。
检查 urls.py 文件: 在 urls.py 文件中，确保已添加以下代码，以便在开发模式下提供媒体文件。
```
from django.conf import settings
from django.conf.urls.static import static
from django.urls import path
from . import views

urlpatterns = [
    # 其他 URL 模式
    # path('', views.index, name='index'),  # 示例
]

if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
```
登录后复制
注意: from django.conf.urls.static import static 必须正确导入。这段代码仅用于开发环境 (settings.DEBUG = True)。在生产环境中，你需要配置 Web 服务器（如 Nginx 或 Apache）来提供静态文件和媒体文件。

模型定义 (models.py): 检查 ImageField 的 upload_to 属性。

from django.db import models

class Category(models.Model):
    name = models.CharField(max_length=100)

    def __str__(self):
        return self.name

class Gallery(models.Model):
    id = models.AutoField(primary_key=True)
    category = models.ForeignKey(Category, on_delete=models.SET_NULL, null=True)
    title = models.CharField(max_length=100, null=False)
    image = models.ImageField(upload_to='images') # 图片将存储在 MEDIA_ROOT/images 目录下

    def __str__(self):
        return self.title

登录后复制

upload_to 指定了上传图片存储的子目录。 Django 会在 MEDIA_ROOT 目录下创建这个子目录。

4. 权限问题

确保 Django 进程有权写入 MEDIA_ROOT 目录。

解决方案: