应使用 Laravel Pipeline 机制解耦多阶段请求处理：一、手动构建 Pipeline 处理非 HTTP 请求；二、复用中间件机制处理 HTTP 请求；三、通过容器解析类支持依赖注入；四、用闭包实现无依赖轻量逻辑；五、返回响应中断流程。
如果您在 Laravel 应用中需要对请求进行多阶段、可复用、解耦的处理，但发现直接在控制器中堆叠逻辑导致难以维护，则很可能是未正确使用 Pipeline 机制。以下是多种符合 Laravel 原生规范的管道处理请求方法：
一、使用 Illuminate\Pipeline\Pipeline 手动构建请求处理链
该方式适用于非 HTTP 请求上下文（如命令行任务、事件监听器、队列作业）中对任意数据对象执行有序处理，需显式管理输入、中间件流转与终止逻辑。
1、在服务类或控制器中实例化 Pipeline，并通过 app() 辅助函数获取容器绑定的 Pipeline 实例。
2、调用 send($request) 方法传入初始请求对象（如 Illuminate\Http\Request 实例或自定义 DTO）。
3、使用 through() 方法传入中间件类数组，每个类必须实现 handle($passable, Closure $next) 方法，且必须显式返回 $next($passable) 或中断值（如 redirect()、response()）。
4、调用 then() 方法接收最终处理结果，其参数为最后一个中间件的 return 值，不可依赖隐式状态或全局变量传递中间结果。
二、复用 Laravel 中间件机制（推荐用于 HTTP 请求）
此方式不直接操作 Pipeline 类，而是利用框架内置的中间件注册与路由绑定体系，由 Illuminate\Foundation\Http\Kernel 自动调度，具备异常自动转换、日志记录、调试支持等完整能力。
1、创建标准中间件类，确保 handle 方法签名严格为 handle(Request $request, Closure $next)。
2、在 app/Http/Kernel.php 的 $middlewareGroups 数组中注册中间件组（如 'api' 或自定义组 'request_pipeline'）。
3、在路由定义中使用 middleware() 方法绑定中间件组，例如 Route::post('/order', [OrderController::class, 'store'])->middleware(['throttle:60,1', 'validate:order']);。
4、避免在控制器内 new Pipeline::class 并传入 HTTP 中间件类——因中间件期望双参数而 Pipeline 默认只传单参数 $passable，将导致 Undefined variable: next 错误。
三、基于容器解析的类管道步骤（支持依赖注入）
当管道步骤需访问数据库连接、缓存、配置或其他服务时，应避免闭包硬编码依赖，改用容器可解析类并通过 via() 指定调用方法，确保依赖自动注入与生命周期可控。
1、定义管道类，实现 __invoke 或 handle 方法，构造函数或方法中声明所需依赖（如 UserRepository $users）。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
2、在 Pipeline 构建链中使用 pipe() 方法添加该类，并配合 via('handle') 显式指定调用入口。
3、调用 send() 传入请求数据，through() 可留空（因已用 pipe() 添加），then() 定义终值处理。
4、所有 via() 指定的方法必须返回值，否则后续步骤接收 null，引发 Call to a member function on null 类型错误。
四、使用闭包定义轻量级管道步骤（仅限无依赖场景）
适用于临时性、无外部依赖的简单转换逻辑（如字符串清洗、字段补全），需注意闭包捕获变量的静态性及返回值强制要求。
1、在控制器或服务中定义匿名函数，参数仅为 $passable，内部不得引用 $next（Pipeline 不提供）。
2、使用 use 关键字捕获外部变量（如 $prefix, $config），但这些值在 pipeline 构建时刻即固化，无法运行时动态变更。
3、每个闭包末尾必须 return $passable（或新值），否则下一级收到 null。
4、将闭包数组传入 through()，或逐个调用 pipe()，再执行 then() 获取结果。
五、中断管道执行并返回响应
当某一步骤需提前终止流程（如权限拒绝、数据校验失败），可通过返回非 $passable 类型的值（如 RedirectResponse、JsonResponse）实现，但后续步骤必须能安全处理该类型。
1、在中间件或闭包中判断条件成立（如 ! $user->can('edit', $post)）。
2、直接 return response()->json(['error' => 'Forbidden'], 403)，此返回值将跳过所有后续步骤，直接成为 then() 回调的输入。
3、then() 内部需做类型检查（如 $result instanceof Response），避免对响应对象执行模型操作。
4、切勿在中断后仍调用 $next($passable)，否则流程不会停止，可能导致重复响应或数据异常。
