ThinkPHP路由参数自动注入模型依赖bind配置而非控制器类型提示；必须在路由中显式调用bind方法绑定变量与模型，否则参数为null或报404，类型提示仅用于接收结果而非触发绑定。
ThinkPHP 路由参数自动注入模型靠 bind 不是靠控制器参数类型提示
ThinkPHP 6+ 的“路由模型绑定”不是 PHP 自动类型推导或依赖注入容器的常规行为，而是框架在解析路由时主动触发的逻辑。你写 public function read(User $user)，TP 不会凭空把 $user 实例化出来——必须先在路由定义里显式声明绑定关系，否则参数就是 null 或报错。
常见错误现象：控制器方法参数写了 User $user，但实际拿到的是 null，或者抛出 think\exception\HttpException（404）；根本原因是没配置 bind，TP 完全不知道该用哪个字段查、查哪个模型。
- 路由定义中必须用
bind方法注册模型绑定，例如：Route::get('user/:id', 'User/read')->bind(['id' => \app\model\User::class]); - 绑定键名（如
id）必须与路由变量名完全一致，大小写敏感 - 模型类必须继承
think\Model，且主键默认为id；若主键不同，需在模型中定义protected $pk = 'uid'; - 如果路由变量名是
uid，但模型主键是id，TP 默认不会自动映射，得手动指定查询字段：Route::get('user/:uid', 'User/read')->bind(['uid' => [\app\model\User::class, 'uid']]);
绑定失败时 TP 默认返回 404，但你可以自定义未找到逻辑
默认行为是：模型查不到数据就直接抛 HttpException（HTTP 404），不进控制器。这适合 RESTful 场景，但有时你需要区分“ID 格式错误”“记录不存在”“权限不足”等语义，就得接管这个流程。
- 使用闭包绑定可绕过默认 404，例如：
Route::get('user/:id', 'User/read')->bind(['id' => function($value) { return User::find($value) ?: throw new \think\Exception('用户不存在'); }]); - 注意闭包返回值必须是模型实例，不能是数组或 null，否则后续类型提示会失效
- 若想保留 404 但加日志，可在模型的
findOrEmpty()或全局事件ModelNotFound中处理，但路由层已无回调入口
多个路由变量绑定多个模型，bind 支持数组嵌套但不支持交叉依赖
比如 /article/:aid/comment/:cid 同时绑定文章和评论模型，可以，但要注意顺序和独立性。
立即学习“PHP免费学习笔记（深入）”；
- 绑定数组按变量名匹配，互不影响：
Route::get('article/:aid/comment/:cid', 'Comment/read')->bind([ 'aid' => \app\model\Article::class, 'cid' => \app\model\Comment::class ]) - 不能让
cid的查询依赖aid的结果（比如“查某文章下的某条评论”），TP 的bind是并行执行的，不支持链式查询 - 这种关联场景应改用控制器内手动查：
$comment = Comment::where('id', $cid)->where('article_id', $aid)->find();，别硬塞进bind - 若强行用闭包模拟关联，会破坏路由复用性，且无法享受模型绑定的缓存机制
模型绑定后，控制器参数类型提示只是“接收器”，不是“触发器”
很多人以为写了 function show(User $user) 就能自动触发绑定，其实这只是 PHP 的类型约束，TP 的绑定逻辑发生在路由调度前，和这个提示无关。它只负责把绑定结果“塞进”参数，不负责“生成”结果。
- 即使控制器方法签名没写
User $user，只要路由绑定了，TP 仍会执行查询——只是你拿不到实例（因为没参数接收） - 类型提示缺失会导致 IDE 无法推导、PHPStan 报错，但运行时不报错（参数变成普通变量）
- 若模型有大量关联，而你只在部分操作中用到，建议不要全局绑定，优先在需要的地方手动
User::with('profile')->find($id)，避免无谓查询 - TP 8.0 开始支持绑定时传入查询条件数组（如
['status' => 1]），但仅限于静态绑定，动态条件仍需手写
bind。 
