DRF中图片已存储但点击URL无法显示的问题求助

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

Django开发环境下，必须手动配置媒体文件的访问路由，否则无法通过URL直接访问存储的图片。在项目根目录的urls.py中添加以下代码：

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

# 已有的路由配置
urlpatterns = [
    # ... 你的其他路由
    path('api/', include(router.urls)),  # 匹配你的API路由前缀
]

# 仅在开发环境添加媒体文件路由
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

2. 验证settings.py媒体配置 #

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

from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

# 媒体文件存储根目录
MEDIA_ROOT = BASE_DIR / 'media'
# 媒体文件访问基础URL
MEDIA_URL = '/media/'

同时检查user_directory_path函数，确保它生成的路径是MEDIA_ROOT的子目录，示例：

def user_directory_path(instance, filename):
    # 将图片存储到 media/users/用户ID/ 目录下
    return f'users/{instance.user.id}/{filename}'

3. 确保Serializer获取请求上下文 #

虽然ModelViewSet默认会传递请求上下文，但如果存在异常情况，可手动在ViewSet中重写方法确保传递：

class TutorprofileViewSet(ModelViewSet):
    # ... 已有代码
    def get_serializer_context(self):
        context = super().get_serializer_context()
        context['request'] = self.request
        return context

4. 检查文件权限与路径 #

• 确认MEDIA_ROOT目录存在，且Django有读写权限（开发环境可执行chmod 755 media调整权限）。
• 查看数据库中professional_photo字段存储的路径，确认对应文件确实存在于MEDIA_ROOT目录下。

5. 验证生成的URL格式 #

检查Serializer返回的image_url是否为完整绝对URL（如http://localhost:8000/media/users/1/photo.jpg），若为相对路径，需确保前端请求的域名与服务端一致。

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