Pipeline执行后返回值为null，是因为每个中间件函数必须显式return $passable（或新值），否则默认返回null导致后续环节接收null。

为什么 Pipeline 执行后返回值总是 null？

常见现象：链式调用 pipe() 后，then() 回调里拿到的参数是 null 或原始输入没被修改。根本原因是中间件函数没显式 return 下一个值——Laravel 的 Pipeline 不自动透传，每个 pipe 必须手动返回传递给下一个环节的数据。

• 错误写法：function ($passable) { session()->flash('msg', 'done'); }（无返回）→ 下一环节收到 null
• 正确写法：function ($passable) { session()->flash('msg', 'done'); return $passable; }
• 如果中间件要“终止流程”，可返回非 $passable 类型（比如 redirect() 响应），但需确保后续逻辑能处理该类型

then() 的回调参数到底是啥？

then() 接收的回调函数，其第一个参数是整个 pipeline 最终的返回值，也就是最后一个 pipe 函数的 return 值。它不是原始输入的引用，也不自动包含上下文对象——除非你主动把它们打包进去。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

• 原始输入通过 send($value) 传入，之后全程作为 $passable 流转
• 若某个 pipe 返回了新对象（如 new Response(...)），后续 pipe 就会收到这个新对象，then() 也拿到它
• 别依赖“隐式状态”，比如在中间件里改全局变量再指望 then() 读取——不可靠且难测试

如何让中间件接收额外参数（比如配置或服务）？

Laravel Pipeline 默认只把 $passable 作为唯一参数传给每个闭包。要注入其他依赖，得靠 Laravel 容器绑定 + 匿名函数 use 或提前解析。

• 推荐方式：用 via() 指定调用方法，并将中间件定义为类，由容器自动注入依赖：->pipe(PermissionCheck::class)->via('handle')
• 闭包场景下，可用 use ($service, $config) 捕获外部变量，但注意生命周期——这些变量在 pipeline 构建时就已确定，无法动态切换
• 避免在闭包里直接 new 实例，会导致无法 mock、难以复用；优先走容器解析

自定义 Pipeline 类时，through() 数组顺序会影响什么？

顺序决定执行流，但更关键的是：中间件之间是否相互依赖返回值类型。比如 A 返回 Collection，B 期望接收 Collection 并调用 map()，那 B 就必须放在 A 后面。

• 顺序错乱最典型的表现是 “Call to a member function xxx on null” 或 “xxx method does not exist”
• 调试技巧：在每个 pipe 开头加 throw new Exception(gettype($passable).': '.print_r($passable, true)); 快速定位类型断裂点
• 不要为了“统一入口”强行把所有逻辑塞进 pipeline——比如数据库事务、日志记录这类副作用操作，更适合放在 then() 外围处理

实际项目里最容易被忽略的，是中间件的返回值契约：它既不是 void，也不是固定类型，而是由你明确定义的“数据流协议”。一旦某处漏了 return，整条链就静默断掉，debug 成本远高于写的时候多敲两个字符。