Laravel中删除父数据时如何自动删除关联子数据？

我在Laravel中创建了User和UserStatus两张关联表，已在模型和迁移中定义关联关系，且在UserStatus迁移中设置了外键的onDelete('cascade')，但删除父表User的数据时，子表UserStatus的数据并未自动删除。尝试过旧的迁移写法也无效，User还有很多关联关系，无法逐个手动删除，需要实现自动删除关联数据的功能。

User模型 #

class User extends Authenticatable implements MustVerifyEmail
{
    use Notifiable;
    use Friendable;
    use HasApiTokens;

    public function userstatus()
    {
        return $this->hasOne(UserStatus::class);
    }
}

UserStatus模型 #

class UserStatus extends Model
{
    public function user()
    {
        return $this->belongsToOne(User::class);
    }

}

User迁移文件 #

class CreateUsersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->increments('id');
            $table->string('first');
            $table->string('last');
            $table->string('description')->nullable();
            $table->string('phone');
            $table->string('question');
            $table->string('answer');
            $table->string('email')->unique();
            $table->string('country');
            $table->string('city');
            $table->timestamp('email_verified_at')->nullable();
            $table->timestamp('verified')->nullable();
            $table->string('password');
            $table->rememberToken();
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('users');
    }
}

UserStatus迁移文件 #

class CreateUserStatusesTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('user_statuses', function (Blueprint $table) {
            $table->increments('id');
            $table->foreignId('user_id')->constrained('users')->onDelete('cascade')->onUpdate('cascade');
            $table->string('status')->default('InActive');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('userstatuses');
    }
}

问题排查与解决方法 #

1. 确认数据库引擎支持外键 #

MySQL的MyISAM引擎不支持外键约束，必须用InnoDB。可以通过数据库客户端查看表引擎，或者在迁移中显式指定：

Schema::create('users', function (Blueprint $table) {
    $table->engine = 'InnoDB';
    // 其他字段定义...
});

Schema::create('user_statuses', function (Blueprint $table) {
    $table->engine = 'InnoDB';
    // 其他字段定义...
});

2. 修复模型关联方法错误 #

UserStatus模型里的belongsToOne是错误写法，Laravel中一对一关联的从属端应该用belongsTo：

class UserStatus extends Model
{
    public function user()
    {
        return $this->belongsTo(User::class); // 替换belongsToOne为belongsTo
    }
}

3. 检查外键约束是否生效 #

执行SQL语句查看外键定义：

SHOW CREATE TABLE user_statuses;

如果输出中没有ON DELETE CASCADE的配置，说明外键没创建成功。可以重新执行迁移（注意备份数据）：

php artisan migrate:fresh

或者创建单独迁移补加外键：

class AddForeignKeyToUserStatusesTable extends Migration
{
    public function up()
    {
        Schema::table('user_statuses', function (Blueprint $table) {
            $table->foreignId('user_id')
                  ->constrained('users')
                  ->onDelete('cascade')
                  ->onUpdate('cascade')
                  ->change();
        });
    }

    public function down()
    {
        Schema::table('user_statuses', function (Blueprint $table) {
            $table->dropForeign(['user_id']);
        });
    }
}

4. 软删除场景处理 #

如果User模型用了软删除（SoftDeletes trait），数据库级联删除不会触发，因为软删除只是标记deleted_at字段，并未真正删除记录。这种情况需要在模型事件中处理关联删除：

class User extends Authenticatable implements MustVerifyEmail
{
    use Notifiable, Friendable, HasApiTokens, SoftDeletes;

    protected static function booted()
    {
        static::deleting(function ($user) {
            $user->userstatus()->delete();
            // 其他关联模型的删除逻辑也可以在这里添加
        });
    }

    public function userstatus()
    {
        return $this->hasOne(UserStatus::class);
    }
}

5. 确保删除操作触发数据库级联 #

如果用User::where(...)->delete()批量删除，数据库级联应该直接生效；如果是查询模型后删除（$user->delete()），只要外键配置正确也会触发级联。若仍有问题，可手动触发关联删除，但更推荐数据库级联或模型事件的方式。

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