解决保存图片至文件夹与MongoDB时的'str' object has no attribute 'chunks'错误

错误原因 #

你遇到的问题本质是传入save_img_field和save_image_to_folder的value是字符串类型，而非Django上传文件对象（UploadedFile）。只有Django的上传文件对象才具备chunks()方法，字符串自然没有这个属性，所以触发报错。

修复后的代码 #

def save_img_field(value):
    # 校验传入参数类型，确保是上传文件对象
    if not hasattr(value, 'chunks'):
        raise ValueError("传入的value必须是Django上传文件对象")

    # 保存图片到本地静态文件夹
    image_path = save_image_to_folder(value)

    # 用GridFS将图片存入MongoDB
    image_id = fs.put(value, filename=value.name, content_type=value.content_type)

    return {'id': str(image_id), 'path': image_path}


def save_image_to_folder(value):
    # 获取上传文件的实际文件名
    image_name = value.name
    # 用os模块安全拼接路径，适配不同系统
    import os
    image_path = os.path.join('decapolis', 'static', 'img', image_name)

    # 确保目标文件夹存在，避免写入失败
    os.makedirs(os.path.dirname(image_path), exist_ok=True)

    # 分块写入文件到本地
    with open(image_path, 'wb+') as destination:
        for chunk in value.chunks():
            destination.write(chunk)

    return image_path

关键修复点 #

• 参数类型校验：在save_img_field开头增加校验，提前拦截非上传文件对象的错误输入。
• 正确获取文件名：用value.name获取上传文件的真实名称，而非直接将value赋值给image_name（原写法会把对象强制转为字符串，导致路径错误）。
• GridFS参数修正：fs.put的filename参数传入value.name，而非整个value对象。
• 路径安全处理：用os.path.join拼接路径，避免硬编码分隔符适配问题；同时通过os.makedirs确保保存目录存在，防止因文件夹缺失导致写入失败。

额外注意事项 #

• 调用save_img_field时，必须传入Django表单或视图中获取的上传文件对象（比如request.FILES['image']），而非文件名字符串。
• 如果是从本地路径读取文件传入，需要先将路径转换为文件对象（比如用open()打开），同时注意文件模式和资源关闭。

内容的提问来源于stack exchange，提问作者hind.hbashneh