Django Admin含CloudinaryField条目保存时出现fields与body参数冲突错误

问题场景 #

• 项目环境：Django + Django Admin + Cloudinary，MainEntity与Picture为一对多关系，Picture模型使用CloudinaryField存储图片
• 触发异常：用户保存带图片的新条目时，抛出错误request got values for both 'fields' and 'body', can only specify one
• 关联问题：重写Picture模型的save方法后，调用父类save时出现该异常；尝试用traceback获取详细错误时，触发事务错误：An error occurred in the current transaction. You can't execute queries until the end of the 'atomic' block.
• 异常来源：已定位到异常来自request_encode_body方法

已尝试的解决措施 #

• 降级Cloudinary和Django至初始版本
• 检查Cloudinary凭证正确性
• 查阅request_encode_body方法官方文档

排查方向与解决方案 #

1. 检查重写的save方法逻辑 #

异常核心原因是Cloudinary API不允许同时传递fields和body参数，大概率是重写save方法时的逻辑冲突：

• 排查是否手动给CloudinaryField设置了fields属性，同时父类save方法会自动处理请求体内容，导致参数冲突
• 避免直接修改字段的fields属性，改用upload_options通过kwargs传递上传配置

错误示例：

class Picture(models.Model):
    image = CloudinaryField('image')
    main_entity = models.ForeignKey(MainEntity, on_delete=models.CASCADE)

    def save(self, *args, **kwargs):
        # 错误：手动设置fields会和父类save的body参数冲突
        self.image.fields = {'width': 800}
        super().save(*args, **kwargs)

修正写法：

def save(self, *args, **kwargs):
    # 通过upload_options传递上传参数，避免参数冲突
    kwargs['upload_options'] = {'width': 800, 'crop': 'limit'}
    super().save(*args, **kwargs)

2. 解决事务内调试的错误 #

Django Admin操作默认处于atomic事务块中，此时不能在异常处理中执行数据库查询。可以通过以下方式获取完整错误栈：

• 开启DEBUG模式，查看控制台输出的完整错误信息
• 用日志记录异常，避免在事务内执行查询操作：

import logging

logger = logging.getLogger(__name__)

def save(self, *args, **kwargs):
    try:
        super().save(*args, **kwargs)
    except Exception as e:
        logger.exception("保存Picture实例时出错")
        raise  # 重新抛出异常，不中断事务逻辑

3. 验证Cloudinary配置与版本适配 #

• 确认settings.py中Cloudinary配置正确（CLOUDINARY_URL或相关参数无拼写错误）
• 即使降级了版本，也要检查CloudinaryField的使用是否符合当前版本要求，比如初始化参数是否正确

4. 排查Django Admin表单逻辑 #

如果仅在Admin中触发异常，检查：

• 是否自定义了Admin表单，对image字段做了额外处理导致参数冲突
• 是否在Admin的save_model方法中修改了图片上传逻辑

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