在 Laravel 6 中，模型应用了软删除后再次插入记录会出现唯一键冲突，这是因为软删除仅更新 deleted_at 字段而未从数据库物理移除记录。由于查询结果自动排除软删除数据，需要使用 withTrashed 方法获取包含软删除在内的记录，再利用 forceDelete 方法进行硬删除。永久删除记录后，再次插入新数据即可避免冲突并成功执行。
本文基于 yiisoft/yii2-app-advanced 模板，记录了在 RESTful 接口应用中实现 ActiveRecord 软删除功能的过程。通过数据库迁移新增了 is_deleted 和 deleted_at 字段，重新生成模型类并附加软删除行为，同时配置了自定义 ActiveQuery 类。经测试，软删除逻辑已替换原有的状态标记，能够确保已删除数据的用户名可被复用，且列表查询默认过滤已删除资源，符合预期。
👨💻 个人品牌
王世强｜技术实践者 · 独立博客作者
15+ 年 Web 与系统实践经验，持续关注网站基础设施、系统优化、AI 工具与自动化。
持续运营技术博客 10+ 年，累计发布 1000+ 篇原创技术文章。
长期建设个人项目，也欢迎合适的技术交流、咨询与合作。
.env (14) 404 (14) add (16) AI 翻译 (36) Array (19) A Tour of Go (78) CentOS (23) ChatGPT (31) ChatGPT Plus (18) chrome (19) Cloudflare (40) Codex (28) composer (42) composer.json (22) composer update (14) console (16) Container (25) curl (16) delete (31) Docker (33) Dockerfile (15) EdgeOne (35) environment variable (19) error (24) file (15) filter (20) Git (28) GitHub (23) Gitlab (15) GLM-5.2 (27) Go (85) go-tour-i18n (16) Google AdSense (30) Go 文档 (16) Go 语言 (24) GraphQL (24) GraphQL API (14) Gutenberg (36) http (21) https (23) Interface (19) json (24) Laravel (37) Laravel 6 (55) Laravel 9 (25) Lighthouse (17) Lighthouse 5 (14) Linux (22) Module (17) MySQL (78) MySQL 5.7 (22) Nginx (63) normalize.css (28) OKX (15) OneinStack (23) PHP (68) php-fpm (21) php.ini (24) PHP 7.1.12 (22) PHP 7.4 (26) phpmyadmin (15) PhpStorm (24) Polylang (59) postman (18) Query (17) queue (16) Rancher (24) Redis (53) RESTful (27) RESTful API (23) SEO (14) Shopify (19) SlyTranslate (22) SQL (24) String (14) TortoiseGit (14) Twenty Twenty-Five (20) Ubuntu (43) update (20) VPN (17) W3 Total Cache (41) Windows 10 (46) WireGuard (29) WordPress (136) WPCode (23) Wstunnel (16) Yii (40) Yii 2 (70) Yii 2.0 (51) ZgoCloud (14) 国际化 (17) 多语言翻译 (51) 开源项目 (16) 技术博客 (15) 故障排查 (20) 数据库迁移 (16) 本地化 (22) 浏览器 (14) 阿里云 (20) 页面缓存 (14)
