可调用控制器（__invoke）是专为单入口场景设计的语义明确形态，仅适用于无资源概念、逻辑边界清晰的请求（如 /health），laravel 9+ 禁用字符串路由写法，必须用 [controller::class] 数组形式注册，且支持构造函数与 __invoke 参数双重依赖注入。
可调用控制器（__invoke）不是“简化版控制器”，而是**专为单入口场景设计的语义明确的控制器形态**——它不替代标准控制器，只在真正符合“一个 URL 对应一个确定动作”的时候才该用。
什么时候必须用 --invokable 而不是 --resource 或空壳？
当你需要处理的请求没有资源概念、不涉及增删改查周期，且逻辑边界清晰时：--invokable 才是合理选择。比如：
-
/health：只返回状态，不读模型、不渲染模板、不带分页或搜索参数 -
/webhook/stripe：接收第三方回调，解析 payload 并触发事件，不展示页面 -
/api/trigger-backup：发起异步任务，返回任务 ID，不返回列表或详情
反例：写成 php artisan make:controller BackupController --invokable，但里面塞了 index() 查任务列表、show() 查单个状态——这已经违背 __invoke 的语义，后续维护者会困惑，IDE 也无法正确跳转。
Route::get('/health', [HealthController::class]) 为什么不能写成字符串？
Laravel 9+ 彻底弃用字符串形式的控制器路由语法（如 'HealthController'），因为无法做静态分析、类型检查和 IDE 支持。错误写法会直接报 Class name must be a string，即使类存在也加载失败。
正确注册方式只有这一种：
use App\Http\Controllers\HealthController;
Route::get('/health', [HealthController::class]);
注意：[HealthController::class] 是数组，不是字符串；HealthController 必须已声明命名空间，且文件路径与 PSR-4 匹配（如放在 app/Http/Controllers/ 下，则命名空间必须是 App\Http\Controllers）。
__invoke 方法里怎么安全地注入依赖？
__invoke 支持完整依赖注入，和构造函数注入不冲突，但要注意生命周期和职责分离：
- 构造函数注入适合「控制器实例生命周期内复用」的服务（如日志、缓存客户端）
-
__invoke参数注入适合「本次请求专属」的依赖（如Request、HealthChecker、NotificationService） - 避免在构造函数和
__invoke中重复注入同一个接口（比如都注入Request），会导致容器解析两次，且Request实例可能不一致
示例：
public function __invoke(HealthChecker $checker, Request $request)
{
return response()->json($checker->check($request->input('verbose')));
}
从其他控制器里调用 __invoke 方法要注意什么？
不要 new 实例 + 手动传 Request 对象，Laravel 的 Request 不是普通 DTO，它绑定着输入源、session、验证上下文等。直接 new 会导致 $request->all() 返回空数组。
更可靠的做法是把业务逻辑抽离到 service 类，让两个控制器都调用它：
- 把健康检查逻辑放进
App\Services\HealthService -
HealthController::__invoke()和另一个控制器里的方法都通过app(HealthService::class)或构造注入来使用它 - 这样既可测试、又可复用、还不耦合请求生命周期
如果真要跨控制器调用（极少数情况），请确保目标控制器方法不依赖 Request 的完整上下文，而是接受原始参数（如 public function __invoke(string $mode)），否则迟早掉坑里。
