常见原因是在非Laravel项目根目录运行或Composer自动加载未刷新；若提示“Command not defined”，可能是Laravel版本过旧导致CommandsServiceProvider未加载。
php artisan make:controller 生成失败的常见原因
直接运行 php artisan make:controller 报错，大概率不是命令写错了，而是当前目录不在 Laravel 项目根目录下，或者 Composer 自动加载没刷新。
- 先确认你在
artisan文件所在目录（即composer.json同级），执行pwd或dir看一眼路径 - 如果提示
Command "make:controller" is not defined，说明 Laravel 的Illuminate\Foundation\Console\CommandsServiceProvider没加载——通常是 Laravel 版本太老（app/Providers/AppServiceProvider.php 被误删/注释了Artisan::command()相关逻辑 - 运行完命令后控制器类没出现在
app/Http/Controllers/？检查是否用了--force但文件已存在且权限受限（比如 Docker 容器内宿主机挂载目录只读）
带资源路由的 Controller 必须加 --resource 参数
想让 Laravel 自动生成 index、show、store 等七个标准方法，光写 php artisan make:controller PostController 是不够的——它默认只生成空类。不加参数等于白搭。
- 正确命令是：
php artisan make:controller PostController --resource - 如果还要带模型绑定（例如自动注入
Post $post），再加--model=Post，变成：php artisan make:controller PostController --resource --model=Post -
--resource不会自动注册路由，你仍需在routes/web.php或routes/api.php里手动写Route::resource('posts', PostController::class);
控制器命名必须符合 PSR-4 和 Laravel 命名约定
Laravel 对控制器类名和文件路径强校验，错一个字母或大小写就找不到类，报 Class "App\Http\Controllers\PostController" not found。
- 类名必须以
Controller结尾，且首字母大写：✅PostController，❌postcontroller、PostsController（除非你真要复数形式，但路由和视图路径也要同步改） - 文件必须放在
app/Http/Controllers/下（Laravel 8+ 默认），子目录如Admin/也行，但类命名空间得同步，比如app/Http/Controllers/Admin/UserController.php对应namespace App\Http\Controllers\Admin; - 如果用了自定义命名空间（比如
--namespace=Api\V1），生成后记得检查use语句和路由里的控制器引用是否匹配，否则Route::get(..., [Api\V1\UserController::class, 'index'])会因命名空间缺失而报错
生成后 controller 方法里 request() 和 validate() 的坑
用 --resource 生成的 store 和 update 方法默认没做表单验证，很多人直接往里塞 request()->validate(...)，结果发现错误不跳转、没闪存 session，或者 API 返回 500 而不是 422。
- Web 路由建议用 Form Request：运行
php artisan make:request StorePostRequest，把规则写进rules()方法，然后在控制器里类型提示它：public function store(StorePostRequest $request)—— 这样自动重定向 + 错误闪存 - API 路由不能依赖重定向，得用
Validator::make(...)->validate()或继续用 Form Request，但要在failedValidation()里 throwValidationException，否则返回的是 HTML 错误页 -
request()->validate()在 API 中可用，但必须确保中间件包含EnsureFrontendRequestsAreStateful::class（仅 Sanctum）或使用api中间组，否则 CSRF 验证失败导致 419
控制器生成只是起点，真正卡住人的从来不是命令本身，而是命名空间拼错、路由没配、验证逻辑混用 Web/API 场景——这些地方一漏，调试时间远超生成时间。
