Laravel Artisan迁移删除Sqlite列抛出异常求助

我正在为一个遗留Laravel项目搭建单元测试，项目中的数据库迁移脚本在MySQL中运行正常。为避免持久化测试数据，我通过.env.testing配置了Sqlite数据库，但其中一个迁移执行时抛出异常。

迁移代码如下：

public function up()
{
    Schema::table('product_variants', function (Blueprint $table) {
        $table->dropColumn(['sku']);
    });
}

在Sqlite下触发的异常：

Doctrine\DBAL\Schema\Index::_addColumn(): Argument #1 ($column) must be of type string, null given, called in /var/www/html/vendor/doctrine/dbal/src/Schema/Index.php on line 72

查阅文档得知Sqlite不支持批量删列，我已将参数从数组['sku']改为字符串'sku'，但问题未解决。

编辑1：根据提示，该列带有索引，我尝试用Doctrine SchemaManager查找索引：

$sm = Schema::getConnection()->getDoctrineSchemaManager();
$indexesFound = $sm->listTableIndexes('product_variants');
var_dump($indexesFound);die;

预期返回类似product_variants_sku_unique的索引名，但实际得到空数组array(0){}。

编辑2：尝试手动删除索引：

Schema::table('product_variants', function (Blueprint $table) {
    $table->dropUnique('product_variants_sku_unique');
});

使用其他名称会提示索引不存在，说明该索引确实存在，但删除索引后再删列仍抛出相同异常。

针对Sqlite与Laravel迁移的兼容性问题，提供以下几种可行方案：

方案1：用原生SQL处理索引和列删除 #

Sqlite的ALTER TABLE支持有限，Laravel的Schema构建器在处理带索引列删除时可能出现Doctrine相关错误。可以直接用原生SQL针对Sqlite做兼容处理：

public function up()
{
    $driver = Schema::getConnection()->getDriverName();
    if ($driver === 'sqlite') {
        // 先删除对应索引
        DB::statement('DROP INDEX IF EXISTS product_variants_sku_unique');
        // 再删除sku列
        DB::statement('ALTER TABLE product_variants DROP COLUMN sku');
    } else {
        // 其他数据库保留原有逻辑
        Schema::table('product_variants', function (Blueprint $table) {
            $table->dropColumn('sku');
        });
    }
}

方案2：新建表迁移数据（Sqlite通用兼容方案） #

如果原生SQL仍无法解决，这是Sqlite下修改表结构的通用兜底方案：

1. 创建与原表结构一致的新表，移除sku列
2. 将原表数据迁移到新表
3. 删除原表并将新表重命名为原表名

代码示例：

public function up()
{
    $driver = Schema::getConnection()->getDriverName();
    if ($driver === 'sqlite') {
        // 构建新表结构（复制原表所有字段，排除sku）
        Schema::create('product_variants_new', function (Blueprint $table) {
            $table->id();
            // 替换为原表实际存在的字段，例如name、price等
            $table->string('name');
            $table->decimal('price', 8, 2);
            // 同步原表的索引、时间戳等约束
            $table->timestamps();
        });

        // 迁移数据
        DB::statement('INSERT INTO product_variants_new SELECT id, name, price, created_at, updated_at FROM product_variants');

        // 删除旧表并重命名新表
        Schema::drop('product_variants');
        Schema::rename('product_variants_new', 'product_variants');
    } else {
        Schema::table('product_variants', function (Blueprint $table) {
            $table->dropColumn('sku');
        });
    }
}

方案3：优化测试环境配置 #

在.env.testing中使用内存Sqlite并禁用外键，减少迁移兼容性问题：

DB_CONNECTION=sqlite
DB_DATABASE=:memory:
DB_FOREIGN_KEYS=false

同时在测试基类的setUp方法中确保每次测试重新执行迁移：

protected function setUp(): void
{
    parent::setUp();
    $this->artisan('migrate:fresh');
}

内存数据库不仅避免了持久化问题，还能提升测试执行速度。

内容的提问来源于stack exchange，提问作者Richard Parnaby-King