Laravel线上cPanel环境下properties表user_id字段添加外键并设置ON DELETE CASCADE不生效问题

看起来你遇到了数据库外键级联删除不生效的问题，虽然执行SQL后MySQL返回了空结果集，但这不代表外键约束已经成功创建或者正常工作。咱们一步步来排查和解决这个问题：

• 第一步：确认外键约束是否真的存在
  先执行这条SQL，查看properties表的创建语句，检查是否包含你定义的外键：

  SHOW CREATE TABLE properties;
  

  如果输出里找不到fk_properties_user这个约束，说明外键根本没创建成功，接下来就要找失败的原因。

• 第二步：检查字段类型是否完全匹配
  外键字段和关联的主键字段必须完全一致，比如如果users.id是bigint(20) unsigned，那properties.user_id也得是相同的类型。如果类型不匹配，MySQL可能只会返回警告（甚至静默失败），你可能没注意到。
  先查看两个字段的类型：

  -- 查看users.id的类型
  DESCRIBE users id;
  -- 查看properties.user_id的类型
  DESCRIBE properties user_id;
  

  如果类型不一致，先修改user_id的类型（替换成你users.id的实际类型）：

  ALTER TABLE properties MODIFY COLUMN user_id bigint(20) unsigned;
  

  然后再重新执行你原来的添加外键的SQL。

• 第三步：清理无效的关联数据
  如果properties表中存在user_id值在users表中不存在的记录，外键约束也无法创建。先找出这些无效记录：

  SELECT * FROM properties WHERE user_id NOT IN (SELECT id FROM users);
  

  处理方式有几种：

  • 删除这些无效记录：

    DELETE FROM properties WHERE user_id NOT IN (SELECT id FROM users);
    

  • 如果业务允许user_id为null，将这些记录的user_id设为null：

    UPDATE properties SET user_id = NULL WHERE user_id NOT IN (SELECT id FROM users);
    

  处理完后再重新添加外键。

• 第四步：检查数据库引擎是否支持外键
  MyISAM引擎不支持外键约束，必须使用InnoDB。先确认表引擎：

  SHOW TABLE STATUS LIKE 'properties';
  

  如果Engine列显示MyISAM，修改为InnoDB：

  ALTER TABLE properties ENGINE=InnoDB;
  

  然后再添加外键。

• 第五步：排查Laravel软删除的影响
  如果你的User模型使用了SoftDeletes trait（也就是软删除），执行$user->delete()时，MySQL实际执行的是更新操作（给deleted_at字段赋值），而不是真正的删除。这种情况下，数据库的ON DELETE CASCADE不会触发，因为没有真正删除用户记录。
  解决办法：

  • 如果业务允许，使用forceDelete()方法强制删除用户，这样会触发数据库级联删除：

    $user->forceDelete();
    

  • 或者在User模型中监听软删除事件，手动删除关联的properties：

    protected static function boot()
    {
        parent::boot();
    
        static::deleted(function ($user) {
            // 无论硬删除还是软删除，都会触发这个事件
            $user->properties()->delete();
        });
    }
    

备注：内容来源于stack exchange，提问作者Alphy Gacheru