Laravel

核心功能

本 Skill 是一份针对 Laravel 框架的深度避坑指南，系统梳理了从数据层到部署层的 8 大高频陷阱：

1. Eloquent N+1 查询优化

• 强制使用 with() 预加载关联数据，避免循环内查询
• 支持嵌套预加载 with('posts.comments')
• 使用 withCount() 无加载计数，及 preventLazyLoading() 开发期拦截

2. 批量赋值安全

• 明确区分 $fillable 白名单与 $guarded 黑名单机制
• 警示 $guarded = [] 的全开放风险，推荐显式白名单
• 澄清验证后的请求数据仍需过 mass assignment 过滤

3. 缓存机制陷阱

• config:cache 后 env() 失效的深层原因
• 路由缓存仅支持控制器闭包的限制
• 提供完整的缓存清理命令链

4. 队列系统细节

• 任务类属性序列化机制（模型转为 ID 再还原）
• 闭包不可入队的限制
• 失败任务表监控及重试策略配置

5. 中间件与路由

• 中间件执行顺序对请求生命周期的影响
• 全局/分组/路由级中间件的适用场景
• Terminable 中间件的响应后执行特性

6. 数据库操作

• migrate:fresh 的破坏性风险
• 事务自动回滚边界
• 软删除查询的默认排除行为

7. 测试最佳实践

• RefreshDatabase 的事务级速度优势
• Factory 的 create() 与 make() 区分
• 队列伪造用于异步逻辑断言

8. 常见编码错误

• find() 与 findOrFail() 的 null 安全选择
• env() 在缓存配置中的失效
• 验证规则 required 与 filled 的语义差异

显著优点

• 实战导向：每条规则均对应真实生产事故场景
• 安全优先：批量赋值、N+1、SQL 注入等安全敏感点全覆盖
• 性能意识：缓存策略、查询优化、测试速度均有涉及
• 版本兼容：聚焦 Laravel 核心机制，长期有效

潜在局限

• 未覆盖 Laravel 10+ 最新特性（如 Process facade、Prompts）
• 缺乏具体性能基准数据（如 N+1 优化前后的查询次数对比）
• 队列部分未涉及 Horizon 监控配置
• 测试章节未包含 Pest/Parallel testing 现代方案

适合人群

• 中级 Laravel 开发者（已熟悉基础 CRUD，追求代码质量）
• 从其他框架迁移至 Laravel 的工程师
• 代码审查负责人（可作为 Checklist 使用）
• 准备 Laravel 认证考试的开发者

常规风险

• 知识过时风险：Laravel 版本迭代快，部分配置可能变化
• 过度防御风险：preventLazyLoading() 在开发期强制崩溃可能影响调试体验
• 配置误用风险：$guarded = [] 的误用可导致批量赋值漏洞
• 缓存清理遗漏：生产环境错误清理缓存可能引发短暂服务中断