软删除(softDeletes())下name字段唯一键冲突问题求助

你的问题核心是数据库层面的唯一约束没适配软删除逻辑——你只在应用层做了验证排除已删除记录，但数据库里的唯一索引还是仅针对name字段，软删除的记录依然占用着该唯一值，所以插入新数据时数据库会直接抛出冲突错误。

解决分两步：

1. 修改数据库的唯一索引为复合索引 #

把原来单独针对name的唯一约束，改成包含name和deleted_at的复合唯一约束。这样，只有当name相同且deleted_at为空（即未被软删除）的记录才会触发冲突，已删除（deleted_at非空）的同名记录不会影响新数据插入。

生成迁移文件 #

运行Artisan命令创建迁移：

php artisan make:migration update_unique_index_on_aud_etapas_documentos_table

编写迁移逻辑 #

在生成的迁移文件里，先删除旧的唯一索引，再添加复合唯一索引：

public function up()
{
    // 删除原有的name字段唯一索引（索引名通常为aud_etapas_documentos_name_unique，可通过数据库工具确认）
    Schema::table('aud_etapas_documentos', function (Blueprint $table) {
        $table->dropUnique('aud_etapas_documentos_name_unique');
        // 添加复合唯一索引：name + deleted_at
        $table->unique(['name', 'deleted_at']);
    });
}

public function down()
{
    // 回滚操作：删除复合索引，恢复原唯一索引
    Schema::table('aud_etapas_documentos', function (Blueprint $table) {
        $table->dropUnique(['name', 'deleted_at']);
        $table->unique('name');
    });
}

注意：如果原索引名不是上述默认值，可通过数据库信息表或可视化工具（如TablePlus、phpMyAdmin）查看实际索引名。

执行迁移 #

php artisan migrate

2. 确认应用层验证规则有效 #

你当前的验证规则是正确的，它会在插入前检查是否存在未被软删除的同名记录，和数据库的复合索引形成双重保障。可以优化下写法，Laravel的unique规则支持直接链式调用whereNull，无需闭包：

$request->validate([
    'name' => [
        'required',
        'string',
        'max:255',
        Rule::unique('aud_etapas_documentos')->whereNull('deleted_at'),
    ],
    'icon' => 'required|string|max:255',
    'lado_timeline' => 'required|in:left,right', // 注意你这里拼写错误：rigth → right
], $messages);

额外提醒：你的lado_timeline规则里的rigth是拼写错误，改成right后才能正常验证右侧选项。

这样处理后，既解决了数据库层面的唯一键冲突，又保留了应用层的验证逻辑，完全适配软删除的业务需求。

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