Laravel迁移文件中如何为SQL Server正确设置唯一索引？

代码不生效是两个问题叠加导致的：

• SQL Server的唯一约束默认规则和MySQL等数据库不同：唯一索引会将多个NULL值判定为重复条目，如果字段设为可空、且表中已经存在多条sheet字段为NULL的记录，创建唯一索引会直接抛出重复键错误。
• 迁移代码写法错误：
  • unique() 方法的第二个参数是自定义索引名称，不是字段长度，传入50会导致索引定义参数异常；
  • nullable()、comment() 是字段级方法，只能挂在字段定义（比如string()）的链式调用后面，不能挂在索引方法unique()后面，会触发方法不存在的错误；
  • 不需要同时调用index()和unique()，unique()本身就会创建索引，重复加普通索引属于冗余操作。

根据是否需要字段允许多个NULL值，选对应写法即可：

方案1：字段非空、所有值全局唯一 #

调整链式调用顺序，所有字段属性声明放在字段定义后，最后再声明唯一索引。执行迁移前先清理表中sheet字段的重复值（包括重复字符串、如果字段设为非空要提前把所有NULL值更新为合法值）：

public function up()
{
    Schema::table('participants', function (Blueprint $table) {
        $table->string('sheet', 50)
              ->nullable() // 不需要存NULL就删掉这行
              ->comment('...')
              ->unique(); // 无需传额外参数，Laravel会自动生成符合SQL Server规范的索引名
    });
}

方案2：允许字段存多个NULL值、仅非空值唯一 #

SQL Server支持过滤索引实现这个需求，Laravel内置Schema方法没有封装这个能力，直接手写原生SQL创建即可：

// 顶部记得引入DB类
use Illuminate\Support\Facades\DB;

public function up()
{
    // 先定义字段
    Schema::table('participants', function (Blueprint $table) {
        $table->string('sheet', 50)->nullable()->comment('...');
    });
    // 创建带WHERE条件的过滤唯一索引，仅对非NULL值做唯一性校验
    DB::statement('CREATE UNIQUE INDEX participants_sheet_unique ON participants(sheet) WHERE sheet IS NOT NULL');
}

// 回滚迁移时记得处理对应索引
public function down()
{
    // 如果回滚是删除字段，直接删字段会连带删除索引，用这段逻辑即可
    Schema::table('participants', function (Blueprint $table) {
        $table->dropColumn('sheet');
    });
    // 如果仅删除索引不删字段，用下面的语句替换上面的逻辑
    // DB::statement('DROP INDEX participants_sheet_unique ON participants');
}

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