php artisan make:controller 是最稳妥的控制器创建方式，自动生成命名空间、继承关系和基础方法；支持 --invokable 和 --resource 选项；需注意路由参数名与类型提示变量名一致、中间件需手动注册、避免 N+1 查询。
用 php artisan make:controller 创建控制器最稳妥
直接运行命令就能生成标准结构，Laravel 会自动处理命名空间、继承关系和基础方法。不推荐手动新建 PHP 文件——容易漏掉 namespace、use 或父类引用，导致路由调用时报 Class not found。
- 默认生成空控制器：
php artisan make:controller UserController - 加
--invokable生成只含__invoke()的单动作控制器 - 加
--resource生成带 7 个 REST 方法的控制器（index、create、store等） - 资源控制器建议配合
Route::resource()使用，否则方法存在但路由未定义，访问直接 404
控制器方法参数绑定失败？检查路由定义和类型提示
Laravel 默认通过方法参数名匹配路由段（如 {id} → show($id)），但一旦加了类型提示（比如 User $user），就会触发隐式模型绑定——此时要求路由参数名必须和变量名一致，且数据库中必须有对应记录。
- 错误写法：
Route::get('/user/{uid}', [UserController::class, 'show']);+public function show(User $user)→ 绑定失败，$user为 null - 正确写法：要么改路由参数名为
{user}，要么改方法参数为show($uid)并手动查库 - 类型提示还影响性能：隐式绑定会额外执行一次
find()查询，高频接口需留意
为什么 php artisan make:controller 生成的控制器没加 Auth 中间件？
Artisan 命令只负责骨架，不注入业务逻辑或权限控制。即使你在 routes/web.php 里写了 middleware('auth')，控制器本身完全感知不到——中间件是在请求进入控制器前拦截的，控制器内部不会自动判断用户是否登录。
- 需要权限校验时，别在控制器里重复写
if (!auth()->check())，统一靠路由中间件或构造函数里加$this->middleware('auth') - 构造函数中注册中间件支持条件过滤，比如：
$this->middleware('auth')->only(['edit', 'update']) - 注意：构造函数在控制器实例化时就执行，此时请求参数尚未解析，不能依赖
$request或路由参数做判断
控制器里调用模型方法卡顿？警惕 N+1 和重复查询
常见写法如在 index() 里循环调用 $post->user->name，表面看没问题，实际每条 $post 都触发一次 users 表查询。Artisan 命令生成的控制器不包含优化逻辑，得自己补。
- 用
with()预加载：Post::with('user')->get() - 避免在 Blade 模板里写
{{ $post->user->name }}，除非已预加载 - 复杂关联建议用
load()延迟加载，但仅限当前请求上下文有效 - 调试时打开 Laravel Telescope 或在
DB::enableQueryLog()下看真实 SQL 条数
控制器文件本身很薄，真正容易出问题的是它和路由、模型、中间件之间的联动细节。参数名拼错、预加载漏写、中间件挂错位置——这些地方没报错，但行为和预期差很远。
