Laravel 的 Pipeline 不是责任链模式，而是线性、不可中断的函数式调用链；每个阶段必须显式调用 $next($passable) 推进流程，否则静默中断，不抛异常也不自动终止传播。

直接说结论：Laravel 的 Pipeline 不是责任链模式，它本质是**线性、不可中断的函数式调用链**；强行模拟责任链（比如中途 return 退出）会破坏其设计契约，导致后续阶段被跳过但无提示——这是最常踩的坑。

为什么 Pipeline 不等于责任链模式

Laravel 的 Illuminate\Pipeline\Pipeline 没有「拦截并终止传播」的内置机制。每个闭包必须显式调用 $passable（即 $next($passable)）才能进入下一环；不调用就静默结束，不会抛异常，也不会自动跳转到“最终返回值”。这和典型责任链中「处理器决定是否继续传递」的语义不同。

常见错误现象：

• 在中间件里写了 if ($x) return $passable;，结果后续阶段全丢了，调试时发现数据没被处理却无报错
• 误以为 then() 返回值会自动作为下个阶段的输入——其实每个阶段都接收原始 $passable，除非你手动传递修改后的值

正确用法：每个阶段必须调用 $next($passable)

标准写法要求每个可调用对象（闭包或类）都接收两个参数：$passable 和 $next，且必须调用 $next($passable)（或其变体）来推进流程。

示例：对用户数据添加时间戳并过滤敏感字段

use Illuminate\Pipeline\Pipeline;

$result = app(Pipeline::class)
    ->send($user)
    ->through([
        function ($user, $next) {
            $user['created_at'] = now()->toDateTimeString();
            return $next($user); // 必须调用，否则中断
        },
        funct
ion ($user, $next) {
            unset($user['password'], $user['api_token']);
            return $next($user); // 同样必须
        }
    ])
    ->then(function ($user) {
        return $user;
    });

关键点：

• $next 是由 Pipeline 动态注入的闭包，不是你定义的函数名
• 所有中间逻辑必须基于传入的 $user 做修改，并把修改后值传给 $next(...)
• 如果某个阶段想“短路”，只能靠抛异常，不能靠 return 值

想实现责任链？得自己封装或换方案

若真需要「某阶段决定是否继续」的能力（如权限校验失败就终止），Pipeline 不适合直接使用。可行替代方式：

• 用普通数组 + foreach 循环，每个处理器返回布尔值控制是否继续
• 自定义一个带 handle($input, $shouldContinue) 接口的类集合，手动管理流转
• 改用 Laravel 的 Middlewares（在 HTTP 生命周期中天然支持 return response() 中断）

例如简单责任链示例：

$handlers = [
    fn($data) => $data['age'] >= 18 ? true : (abort(403, 'Under age'), false),
    fn($data) => isset($data['email']) ? true : (abort(400, 'Email required'), false),
];

$input = ['age' => 17, 'email' => 'a@b.c'];
foreach ($handlers as $handler) {
    if (!$handler($input)) break;
}

容易被忽略的细节：$next 的执行时机与异常捕获

$next($passable) 实际触发的是下一个阶段的执行，不是“注册”；也就是说，Pipeline 构建时不做任何调用，then() 才真正开始运行整个链条。这意味着：

• 无法在 through() 阶段做类型检查或提前验证
• 异常发生在哪个阶段，堆栈里只会显示 then() 调用点，需结合日志定位具体闭包
• 若某阶段抛出异常，$next 后面的代码不会执行，但前面已完成的操作不可回滚（无事务保障）

所以实际项目中，建议每个阶段尽量轻量、幂等，并在外层加 try/catch 处理整体失败。