tap() 不中断链式调用，它将集合传入闭包并原样返回，适用于调试观测、打点等无副作用操作，不可用于数据变换或替代 save() 的错误处理。
tap() 在集合中怎么用才不中断链式调用
集合（Collection）上的 tap() 是一个无副作用钩子：它把当前集合传入闭包，执行完后原样返回集合本身，不改变内容、不终止链式。这点和 dd() 或 dump() 有本质区别——后者会输出并阻塞后续执行。
常见错误是把它当调试工具滥用：$users->tap(fn($c) => $c->dump())->map(...) 看似合理，但 dump() 不会中断流程，而 dd() 一定会；只要闭包里没抛异常或 exit，链式就继续。
-
tap()闭包参数是Collection实例，不是数组或模型对象 - 适合在中间检查结构，比如
->tap(fn($c) => logger()->info('count', ['n' => $c->count()])) - 不要在闭包里调用
->all()或->toArray()后再处理——那已脱离集合上下文，且可能触发重复计算 - 若需修改集合内容（如加字段），应改用
map()或transform()，tap()不负责变换
为什么在 Eloquent 查询构建器里用 tap() 查不到绑定参数
tap() 接收的是 Builder 实例，调用 $builder->toSql() 只返回带 ? 占位符的 SQL 模板，不包含实际绑定值。这是设计使然：SQL 编译与参数绑定在底层是分离步骤，toSql() 不触碰绑定数据。
想看完整可执行 SQL（仅限本地开发调试），得手动拼接：
->tap(function ($builder) {
$sql = $builder->toSql();
$bindings = $builder->getBindings();
$full = vsprintf(str_replace('?', '%s', $sql), array_map(fn($b) => is_string($b) ? "'$b'" : $b, $bindings));
\Log::debug('Full query', ['sql' => $full]);
})
- 生产环境禁用该写法：字符串插值有注入风险，
vsprintf对非标类型（如Carbon）可能崩 -
getBindings()返回的是原始 PHP 值，未做 PDO 类型转换 - 更安全的替代是开启查询日志：
DB::enableQueryLog()+DB::getQueryLog()，但它捕获的是最终执行语句，不是构建中途状态
tap() 和 pipe() 在集合处理中别混用
tap() 返回原集合，pipe() 返回闭包的返回值——这是根本差异。写错会导致链断裂或类型错乱。
例如想对集合做两次处理：先记录日志，再过滤空邮箱。下面写法是错的：
$users->pipe(fn($c) => $c->tap(...)->filter(...)) // ❌ pipe 期望你 return 新值，但 tap 不改变 $c
正确方式是：
$users
->tap(fn($c) => \Log::info('before filter', ['count' => $c->count()]))
->filter(fn($u) => $u->email)
->tap(fn($c) => \Log::info('after filter', ['count' => $c->count()]))
-
tap()用于观测、打点、轻量副作用（如触发事件、存缓存 key） -
pipe()用于数据流转换，比如pipe($data)->through([Cleaner::class, Validator::class])->thenReturn() - 二者嵌套可行，但语义要清晰：外层
pipe()控制流程走向，内层tap()插入观测点
模型实例上用 tap() 时 save() 不自动发生
tap(User::make([...]))->save() 这种写法看似简洁，但要注意：它只调用模型的 save() 方法，不会自动处理事务、事件、观察者或验证逻辑——除非你的模型显式启用了这些机制。
更危险的是，如果 save() 失败（比如数据库唯一约束冲突），tap() 不捕获异常，也不会回滚，上游代码可能误以为操作成功。
- 推荐显式判断：
if (! tap($user)->save()) { throw new Exception('Save failed'); } - 涉及多模型联动或业务规则时，应封装进 Repository 或 Action 类，而非依赖
tap()的链式糖衣 -
tap()在模型上最有价值的场景是“构造即配置”，比如tap(User::make())->assignRole('editor')->syncPermissions(...)，但每步仍需确认返回值是否符合预期
