Laravel 中的 Action 类是社区实践的单一职责业务类，不属框架原生，应只协调一个核心领域行为，依赖限于数据获取与变更，避免嵌套调用；命名动词开头，通过__invoke接收运行时参数，不可复用，需配单元测试。
直接用 Action 类组织业务逻辑在 Laravel 中完全可行，但官方并未内置 Action 模式——它属于社区实践，不是框架原生概念。是否采用，取决于你能否守住「一个 Action 只做一件事」的边界，否则容易变成新瓶装旧 Service。
什么是 Laravel 中的 Action 类
它是一个普通 PHP 类，通常放在 app/Actions 目录下，不继承任何基类，不实现特定接口，只通过构造函数或方法接收依赖，执行单一业务动作（比如「创建订单并扣减库存」算一个动作；「创建订单」「扣减库存」「发通知」则应拆成三个 Action）。
常见错误现象：ProcessOrderAction 里又调用了 SendEmailService、InventoryClient、NotificationGateway，还自己写事务控制——这已违反单一职责，本质是把 Controller 搬进了 Action 文件。
- 正确做法：每个 Action 只协调 1 个核心领域行为，依赖应限于「数据获取」和「领域变更」，避免嵌套调用其他 Action
- 使用场景：表单提交、后台批量操作、Webhook 处理入口、API 端点主逻辑封装
- 命名建议：动词开头 + 名词，如
AssignTicketToAgent、RefundPaymentForCanceledOrder
如何定义和调用 Action 类
不需要 Trait 或抽象基类。Laravel 的容器能自动解析构造参数，所以重点是让 Action 保持「可测试、可复用、无副作用」。
参数差异体现在：构造函数只注入「稳定依赖」（如 Repository、Client），而运行时数据（如用户输入、ID）应通过 __invoke() 或明确方法传入。
性能影响很小，但若 Action 内部做了 N+1 查询、未加缓存、或同步调用外部 HTTP 接口，会掩盖问题——Action 不是性能兜底层。
app/Actions/ActivateUserAccount.php
<?php
namespace App\Actions;
use App\Models\User;
use Illuminate\Support\Facades\DB;
class ActivateUserAccount
{
public function __construct(
private UserRepository $users
) {}
public function __invoke(int $userId): User
{
return DB::transaction(function () use ($userId) {
$user = $this->users->findOrFail($userId);
if ($user->is_active) {
throw new \InvalidArgumentException('User is already active');
}
$user->update(['is_active' => true]);
return $user;
});
}
}
调用方式简洁：
// 在 Controller 中
public function store(Request $request)
{
$user = app(ActivateUserAccount::class)( $request->integer('user_id') );
return response()->json(['activated' => true]);
}
与现有结构（Service / Job / Policy）怎么区分
容易踩的坑：把 Action 当成 Service 的别名，或当成轻量 Job 来用。关键区别在于生命周期和语义：
-
Service：常含多个方法，面向功能模块（如PaymentService::refund()、PaymentService::capture()），适合被多处复用 -
Action：仅有一个公开入口（通常是__invoke），面向「一次请求意图」，不可复用——比如ImportProductsFromCsv不该被另一个 Action 调用 -
Job：必须异步，有失败重试、队列中间件等契约；Action 默认同步，如需异步应显式 dispatch Job -
Policy：只做权限判断，不修改状态；Action 可以修改，但绝不应混入授权逻辑（授权应前置到中间件或 Policy）
兼容性影响：Laravel 9+ 的类型化集合、enum 支持、PHP 8.2 的只读类都能用在 Action 中，但别为了“新语法”而增加复杂度——多数 Action 不需要 readonly 属性或枚举返回值。
真正难的是职责边界的判断
比如「用户注册」要不要拆成 CreateUser + SendWelcomeEmail + CreateUserProfile？答案取决于业务变化频率：如果邮箱模板每月一换、Profile 字段每两周加一个，那就必须拆；如果三者永远原子性成功或失败，且从不单独触发，合并在一个 Action 里更清晰。
最容易被忽略的地方：没有为 Action 写单元测试就上线。因为 Action 没有路由、没有视图，很容易被当成“临时胶水代码”跳过测试。但恰恰是它承载了最核心的业务规则——漏测等于放行逻辑漏洞。
