Wagtail模型添加CheckConstraint报错：column 'live'不存在，求解决方案

问题原因 #

Wagtail的Page模型与自定义Article模型采用多表继承机制，Page的内置字段（包括live）存储在独立的wagtailcore_page表中，而Article模型的字段（如price）存储在自身的关联数据表中。数据库层面的CheckConstraint仅能约束当前表内的字段，无法跨表引用其他表的字段，因此执行migrate时数据库找不到live列，触发ProgrammingError。

解决方案 #

方法一：使用Wagtail发布钩子做业务验证（推荐） #

利用Wagtail的before_publish_page钩子，在页面发布前校验价格规则，避免数据库层面跨表约束的问题：

from wagtail.signals import before_publish_page
from django.dispatch import receiver
from django.core.exceptions import ValidationError
from .models import Article

@receiver(before_publish_page)
def validate_published_article_price(sender, page, **kwargs):
    if isinstance(page, Article):
        # 仅在发布时校验价格（live状态会在发布后变为True）
        if page.price is not None:
            if page.price < 100:
                raise ValidationError("发布的文章价格不能低于100")
            if page.price > 350000:
                raise ValidationError("发布的文章价格不能超过350000")

该方法符合Wagtail的原生工作流，无需修改数据库结构，在页面发布环节拦截不符合规则的内容。

方法二：同步live状态到当前表，添加数据库约束 #

如果需要数据库层面的强约束，可在Article模型中新增字段同步live状态，再基于该字段添加约束：

1. 修改Article模型：

from wagtail.models import Page
from django.db import models
from django.db.models import Q, CheckConstraint

class Article(Page):
    price = models.PositiveIntegerField(null=True, blank=True)
    # 新增字段同步live状态，设为不可编辑
    is_live = models.BooleanField(default=False, editable=False)
    
    class Meta:
        constraints = [
            CheckConstraint(check=Q(price__gte=100) & Q(is_live=True), name="min_price_for_published"),
            CheckConstraint(check=Q(price__lte=350000) & Q(is_live=True), name="max_price_for_published"),
        ]

2. 添加信号同步is_live字段：

from wagtail.signals import page_published, page_unpublished
from django.dispatch import receiver
from .models import Article

@receiver(page_published)
def sync_is_live_on_publish(sender, page, **kwargs):
    if isinstance(page, Article):
        page.is_live = True
        page.save(update_fields=['is_live'])

@receiver(page_unpublished)
def sync_is_live_on_unpublish(sender, page, **kwargs):
    if isinstance(page, Article):
        page.is_live = False
        page.save(update_fields=['is_live'])

3. 执行迁移命令：

python manage.py makemigrations
python manage.py migrate

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