Django Rest结合GridFS存储MongoDB Atlas图片后无法获取访问链接求助

文件已成功存入MongoDB GridFS，但未配置对应的HTTP访问路由、也未实现从GridFS读取文件返回的视图。API返回的profile_pic链接指向的路径无合法处理逻辑，Django无法匹配对应视图，最终返回异常跳转页面。

1. 调整视图权限过滤 #

首先修正ProfilePicView的查询范围，避免返回所有用户的头像记录，仅暴露当前登录用户的头像数据：

# views.py 调整原有ProfilePicView
class ProfilePicView(viewsets.ModelViewSet):
    authentication_classes = (authentication.TokenAuthentication,)
    permission_classes = (permissions.IsAuthenticated,)
    serializer_class = ProfilePicSerializer

    # 动态过滤查询集，仅返回当前用户的头像记录
    def get_queryset(self):
        return models.ProfilePic.objects.filter(user=self.request.user)

2. 实现GridFS文件下载视图 #

编写自定义视图从GridFS存储中读取文件，设置正确的响应头后返回给客户端：

# views.py 新增代码
from django.http import HttpResponse, Http404
from gridfs import GridFS
from gridfs.errors import NoFile
from pymongo import MongoClient
from django.conf import settings

# 初始化MongoDB连接（如果项目已有现成的MongoDB连接实例，直接复用即可，避免重复创建连接）
client = MongoClient(settings.MONGO_URI)
db = client[settings.MONGO_DB_NAME]
fs = GridFS(db, collection='myfiles')

def serve_gridfs_file(request, file_path):
    # 先校验请求用户身份
    if not request.user.is_authenticated:
        raise Http404("无权访问")
    
    try:
        # GridFS中存储的文件名包含你设置的upload_to='users'前缀，拼接完整路径读取
        file = fs.get_last_version(filename=f'users/{file_path}')
    except NoFile:
        raise Http404("文件不存在")
    
    # 安全校验：确认该文件属于当前请求用户，避免越权访问
    if not models.ProfilePic.objects.filter(
        profile_pic=f'users/{file_path}',
        user=request.user
    ).exists():
        raise Http404("无权访问")

    # 设置响应头，保证浏览器正确识别图片类型
    response = HttpResponse(file.read(), content_type=file.content_type)
    response['Content-Disposition'] = f'inline; filename="{file.filename.split("/")[-1]}"'
    return response

注意：如果使用django-storages或django-mongoengine封装的GridFSStorage，无需手动初始化GridFS连接，直接调用obj.profile_pic.storage.open(obj.profile_pic.name)即可读取文件。

3. 配置访问路由 #

在项目的urls.py中新增对应路径的路由，和文件访问路径完全匹配：

# urls.py 新增代码
from django.urls import path
from .views import serve_gridfs_file

urlpatterns = [
    # 原有DRF路由配置
    path('myfiles/<path:file_path>/', serve_gridfs_file, name='gridfs-file'),
]

4. 修正Serializer返回的头像路径 #

删除硬编码的BASE_URL配置，避免不同部署环境下域名不匹配的问题，返回相对访问路径即可：

# serializers.py 调整后代码
class ProfilePicSerializer(serializers.ModelSerializer):
    # 重写字段，返回和路由匹配的相对路径
    profile_pic = serializers.SerializerMethodField()

    class Meta:
        model = models.ProfilePic
        fields = ('id', 'profile_pic')

    def get_profile_pic(self, obj):
        if not obj.profile_pic or obj.profile_pic.name == 'avatar.png':
            # 可以返回默认头像的对应静态路径
            return '/static/avatar.png'
        return f'/myfiles/{obj.profile_pic.name.replace("users/", "")}'

• 生产环境不要使用Django内置开发服务器处理文件下载，可搭配Nginx缓存或反向代理优化响应速度
• 如果需要支持默认头像的逻辑，可将默认头像文件存放在本地静态目录，直接通过静态路由访问即可，无需存入GridFS
• 原有models.py中硬编码的base_url配置可以删除，相对路径会自动适配当前域名

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