Wagtail 5 + Django 4.2.2连接MSSQL迁移失败问题求助

支持性说明 #

Wagtail依赖Django的数据库适配能力，Django 4.2正式支持Microsoft SQL Server（需搭配mssql-django适配器），因此Wagtail v5搭配Django 4.2.2可以使用MSSQL作为数据库，但部分迁移操作会因SQL Server的约束特性出现兼容问题。

报错原因分析 #

你遇到的报错是因为迁移操作尝试修改content_type_id列，但该列被索引content_object_idx关联依赖。SQL Server不允许直接修改被索引绑定的列，必须先移除依赖的索引，修改列后再重建索引。

解决方案 #

方法一：修改迁移文件（推荐） #

1. 定位失败的迁移文件：查看迁移执行日志，找到触发报错的迁移（通常属于wagtailcore或涉及GenericForeignKey的应用）。
2. 编辑迁移文件：在修改content_type_id列的AlterField操作前后，分别添加删除和重建索引的步骤，示例如下：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        # 保留原迁移依赖
    ]

    operations = [
        # 先删除关联索引
        migrations.RemoveIndex(
            model_name='<模型名称>',
            name='content_object_idx',
        ),
        # 原修改字段的操作
        migrations.AlterField(
            model_name='<模型名称>',
            name='content_type_id',
            field=models.ForeignKey(...), # 保留原字段定义
        ),
        # 重建索引
        migrations.AddIndex(
            model_name='<模型名称>',
            index=models.Index(fields=['content_type_id', 'object_id'], name='content_object_idx'),
        ),
    ]

3. 重新执行迁移：运行python manage.py migrate完成迁移。

方法二：手动操作SQL Server #

1. 删除索引：打开SQL Server管理工具，执行以下SQL（替换<表名>为实际表名）：

DROP INDEX content_object_idx ON <表名>;

2. 执行迁移：在项目中运行python manage.py migrate。
3. 重建索引：回到SQL Server，执行以下SQL：

CREATE INDEX content_object_idx ON <表名> (content_type_id, object_id);

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