Django中ArrayField默认值设置失败问题求助

Let me walk you through how to fix those frustrating default value issues with Django's ArrayField— I've been there too, so I know how confusing it can be when all your initial attempts throw errors.

First, let's break down why your previous attempts didn't work:

• Using default={}, default='{}', or default={''}: ArrayField expects a list-like structure (not a dictionary or string representation of one), so these types don't match the field's requirements, hence the errors.
• Using default=list(): This creates a single empty list instance that gets shared across all model instances. Any change to one instance's array will affect all others— a classic Django gotcha with mutable default values.
• null=True only allows the field to store NULL values, but it doesn't set a default empty array; you still need to define the default correctly alongside it if that's what you want.

Correct Ways to Set Default Values for ArrayField #

Here are the reliable approaches that work every time:

1. Use the list constructor as a callable
   This is the simplest method for an empty default array. Since list is a callable, Django will create a fresh empty list for each new model instance, avoiding shared state issues.

   from django.contrib.postgres.fields import ArrayField
   from django.db import models
   
   class YourModel(models.Model):
       your_array = ArrayField(
           models.CharField(max_length=100),
           default=list  # No parentheses here!
       )
   

2. Use a lambda function for custom defaults
   If you need a default array with initial values (not just empty), use a lambda to return a new list each time:

   class YourModel(models.Model):
       tagged_items = ArrayField(
           models.CharField(max_length=50),
           default=lambda: ['initial-tag-1', 'initial-tag-2']
       )
   

3. Combine with null=True (if needed)
   If you want to allow the field to be NULL and have an empty array as the default, just add null=True alongside your callable default:

   class YourModel(models.Model):
       optional_array = ArrayField(
           models.IntegerField(),
           default=list,
           null=True
       )
   

Just remember: never use a mutable object (like [] or list()) directly as the default— always use a callable that generates a new instance each time. That's the key to avoiding those weird shared-state bugs and validation errors.

内容的提问来源于stack exchange，提问作者Malik A. Rumi