Django API 图片下载与同步完整教程-Python教程-PHP中文网

Django API 图片下载与同步完整教程

本文介绍如何通过 django rest framework 构建可下载图片的 api，使协作者克隆项目后能自动获取远程图片并保存到本地媒体目录，解决仅同步路径却无实际文件的问题。

本文介绍如何通过 django rest framework 构建可下载图片的 api，使协作者克隆项目后能自动获取远程图片并保存到本地媒体目录，解决仅同步路径却无实际文件的问题。

在 Django 博客项目中，当多人协作开发（如朋友克隆 GitHub 仓库）时，仅同步数据库记录（如 ImagePost 的 image 字段路径）是不够的——因为 ImageField 存储的是相对路径（如 blog_posts/photo.jpg），而真实文件并未随代码一同传输。要真正实现图片“可下载、可复现”，需两步协同：服务端提供可访问的图片 URL，客户端主动下载并持久化到本地 media 目录。

✅ 第一步：修改序列化器，暴露可访问的图片 URL

默认 ImageField 在 DRF 中序列化后返回的是路径字符串（如 /media/blog_posts/photo.jpg），但该路径对远程客户端无效。应改用 ImageField(use_url=True)，使其返回完整的、可通过 HTTP 访问的绝对 URL：

# serializers.py
from rest_framework import serializers
from .models import ImagePost

class ImagePostSerializer(serializers.ModelSerializer):
    # 关键：use_url=True 启用 URL 生成（依赖 MEDIA_URL 配置）
    image = serializers.ImageField(use_url=True)

    class Meta:
        model = ImagePost
        fields = ["id", "image"]

⚠️ 前提条件：

确保已安装 Pillow：pip install Pillow
开发环境下，必须在主 urls.py 中启用媒体文件服务（生产环境需由 Nginx/Apache 处理）：

# urls.py
from django.conf import settings
from django.conf.urls.static import static
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/', include('your_api_app.urls')),
]

# 仅开发环境启用 —— 生产环境请勿使用！
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

同时确认 settings.py 中已正确定义：

# settings.py
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')  # 或其他你指定的绝对路径

此时，调用 /api/imagepost/list/ 将返回类似：

Django

避免常见的 Django 错误——QuerySet 评估、N+1 查询、迁移冲突和 ORM 陷阱。

下载

[
  {
    "id": 1,
    "image": "http://localhost:8000/media/blog_posts/flower.jpg"
  }
]

✅ 第二步：客户端下载图片并保存至本地 media 目录

原 create_imagepost_from_url_json 函数仅创建模型实例，未处理图片文件下载。需增强逻辑：解析 URL → 下载二进制内容 → 保存为 Django 文件对象 → 绑定到新 ImagePost 实例：

# views.py
import os
import requests
from django.core.files import File
from django.core.files.base import ContentFile
from django.shortcuts import redirect
from django.contrib.sites.shortcuts import get_current_site
from .models import ImagePost

def create_imagepost_from_url_json(request):
    current_site = get_current_site(request)
    # 注意：修正原代码中的 domain 元组取值错误
    domain = current_site.domain
    api_url = f"http://{domain}/api/imagepost/list/"

    response = requests.get(api_url)
    if response.status_code != 200:
        raise Exception(f"API request failed: {response.status_code}")

    data = response.json()
    for item in data:
        # 1. 提取远程图片 URL
        remote_image_url = item.get("image")
        if not remote_image_url:
            continue

        # 2. 下载图片内容
        img_response = requests.get(remote_image_url)
        if img_response.status_code != 200:
            continue

        # 3. 构造本地文件名（避免冲突，可加哈希或 ID 前缀）
        filename = os.path.basename(remote_image_url)
        # 可选：确保唯一性，例如 "img_1_flower.jpg"
        # filename = f"img_{item['id']}_{filename}"

        # 4. 创建 ImagePost 实例（暂不保存 image）
        image_post = ImagePost.objects.create(id=item["id"])  # 注意：若 ID 冲突需处理

        # 5. 将下载内容保存为 Django File 并赋值给 image 字段
        image_post.image.save(
            filename,
            ContentFile(img_response.content),
            save=True
        )

    return redirect('index')

? 关键说明：