Django JSONField非空约束报错及Factory Boy测试参数绑定失败求助

我来帮你逐个解决这些和Django JSONField、Factory Boy相关的问题：

这个问题通常出现在两个场景：一是字段没有默认值，且editable=False导致表单不提交该字段；二是你试图把非JSON兼容的数据（比如File对象）存入JSONField。

解决办法：

• 给JSONField设置默认值，确保即使表单不提交，数据库也能拿到合法值：

  field_name = JSONField(editable=False, default=dict)  # 空字典作为默认值
  

• 如果涉及文件类型，绝对不能直接把File实例存进JSONField，要提取文件的关键信息（比如路径、文件名、大小）转成字典再存储，比如：

  # 假设你有一个上传的文件对象file_obj
  self.field_name = {
      'filename': file_obj.name,
      'file_path': file_obj.path,
      'size': file_obj.size
  }
  

editable=False的字段不会出现在Admin的表单里，当你保存对象时，这个字段不会被表单提交，如果数据库要求该字段非空且没有默认值，就会触发约束错误。

解决办法：

• 最简单的方式是给字段加默认值，参考上面的代码；
• 或者在模型的save()方法里手动初始化空字段：

  def save(self, *args, **kwargs):
      # 如果字段为空，初始化空字典
      if not self.field_name:
          self.field_name = {}
      super().save(*args, **kwargs)
  

• 如果你需要在Admin里间接控制这个字段，可以自定义Admin表单，把它设为隐藏字段，让表单自动提交默认值：

  from django.contrib import admin
  from django import forms
  from .models import YourModel
  
  class YourModelForm(forms.ModelForm):
      # 把字段设为隐藏，确保表单提交它
      field_name = forms.JSONField(widget=forms.HiddenInput(), required=False)
  
      class Meta:
          model = YourModel
          fields = '__all__'
  
  class YourModelAdmin(admin.ModelAdmin):
      form = YourModelForm
  
  admin.site.register(YourModel, YourModelAdmin)
  

你用factory.build(dict, FACTORY_CLASS=NewsProviderFactory)赋值给field_name时，本质上返回的是NewsProvider模型实例，而不是字典——JSONField只能序列化JSON兼容的Python类型（dict、list、字符串等），模型实例无法直接被数据库识别，所以报错。

解决办法：

• 方法一：用DictFactory生成字典
  直接定义一个生成字典的Factory，而不是模型Factory：

  import factory
  
  class NewsProviderDictFactory(factory.DictFactory):
      # 定义你需要的字段，用Faker生成测试数据
      title = factory.Faker('sentence')
      url = factory.Faker('url')
      category = factory.Faker('word')
  
  # 测试时直接调用生成字典
  field_name = NewsProviderDictFactory()
  

• 方法二：从模型实例提取字典
  如果已经有NewsProviderFactory模型Factory，可以先生成实例，再提取需要的字段转成字典：

  news_provider = NewsProviderFactory()
  field_name = {
      'title': news_provider.title,
      'url': news_provider.url,
      'category': news_provider.category
  }
  

• 方法三：给模型Factory加转字典方法
  在现有Factory里添加类方法，直接返回结构化字典：

  class NewsProviderFactory(factory.django.DjangoModelFactory):
      class Meta:
          model = NewsProvider
  
      title = factory.Faker('sentence')
      url = factory.Faker('url')
      category = factory.Faker('word')
  
      @classmethod
      def to_dict(cls):
          # 生成未保存的实例，提取字段
          instance = cls.build()
          return {
              'title': instance.title,
              'url': instance.url,
              'category': instance.category
          }
  
  # 测试时调用：
  field_name = NewsProviderFactory.to_dict()
  

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