Django图片上传至数据库异常：仅存文件名且无上传结果

首先明确：Django的ImageField在数据库中本来就只存储文件的相对路径（含文件名），实际图片文件会保存在你配置的MEDIA_ROOT目录下。你需要先确认文件是否真的没上传到服务器目录，再针对性排查问题：

1. 检查依赖库是否安装 #

ImageField依赖Pillow库处理图片，未安装会导致上传失败：

pip install pillow

2. 修复HTML表单语法错误 #

你的upload.html中按钮标签未闭合，存在语法截断，会导致表单提交异常，补全按钮代码：

<button type="submit" name="upload" class="btn btn-gray-800 mt-2 animate-up-2">上传</button>

（注：animate-up-后需补全完整类名，比如animate-up-2，并添加按钮文本和闭合标签）

3. 优化Model的上传路径（可选） #

upload_to参数是相对于MEDIA_ROOT的子目录，当前配置upload_to="media/"会导致文件存在MEDIA_ROOT/media/下，路径冗余，建议调整：

# models.py
class ImageUpload(models.Model):
    idupload = models.AutoField(db_column='idupload', primary_key=True)
    image = models.ImageField(db_column='image', upload_to="images/", null=True)  # 修改为images/
    description = models.CharField(db_column='description', max_length=50, null=True)

    class Meta:
        managed = True
        db_table = 'image_upload'

4. 确认媒体配置正确性 #

确保settings.py中媒体路径配置正确：

# settings.py
import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

MEDIA_ROOT = os.path.join(BASE_DIR, 'media')  # 图片文件存储的本地路径
MEDIA_URL = '/media/'  # 访问图片的URL前缀

5. 配置媒体文件访问路由 #

在项目根urls.py中添加媒体文件的访问路由，否则前端无法访问上传的图片：

# urls.py
from django.conf import settings
from django.conf.urls.static import static
from django.contrib import admin
from django.urls import path
from your_app.views import uploadImage  # 替换为你的app名

urlpatterns = [
    path('admin/', admin.site.urls),
    path('upload/', uploadImage),  # 确保你的上传视图已配置URL
    # 其他路由...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

6. 调试视图逻辑（可选） #

在视图中添加调试代码，确认是否成功获取到上传文件：

# views.py
def uploadImage(request):
    if request.method == 'GET':
        return render(request, 'upload.html')
    if request.method == 'POST':
        image = request.FILES.get('image')
        description = request.POST.get('description')
        # 打印调试，查看是否拿到文件对象
        print("获取到的上传文件：", image)
        if image:  # 确保拿到文件后再创建记录
            ImageUpload.objects.create(image=image, description=description)
        return redirect('/images/')

执行以上步骤后，重新测试上传：若服务器MEDIA_ROOT目录下出现上传的图片，说明上传成功，数据库中存储的路径是正常的；若仍无文件，检查调试打印信息是否拿到文件对象，进一步排查表单提交或路由配置问题。

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