laravel 路由模型绑定会提前查询数据库，导致缓存逻辑被绕过；解决方法是禁用自动绑定，改用原始 id 手动查库并缓存。
laravel 路由模型绑定会提前查询数据库，导致缓存逻辑被绕过；解决方法是禁用自动绑定，改用原始 id 手动查库并缓存。
在 Laravel 8 中使用 Redis 缓存时，若发现缓存“仅在 Tinker 中生效、API 请求却始终不命中”，极大概率是路由模型绑定（Route Model Binding）与缓存逻辑发生了冲突——这正是本案例的核心问题。
? 问题本质：模型绑定提前执行了查询
原代码中使用了隐式模型绑定：
public function show(Application $application) { ... }当请求到达时，Laravel 在进入控制器方法前 就已根据路由参数（如 /api/applications/123）自动执行 Application::find(123) 并注入 $application 实例。此时：
- 数据库查询已发生（耗时 8 秒）；
- Cache::remember(...) 中的闭包实际接收的是一个已加载的 Eloquent 模型对象，而非 ID；
- find($application) 在闭包内调用时，传入的是模型实例（非主键），find() 方法将返回 null 或触发异常（取决于 Laravel 版本），最终缓存存储的是空值或错误结果；
- 后续请求仍重复触发模型绑定 → 持续绕过缓存 → 始终慢。
而你在 Tinker 中手动执行 Application::with(...)->find($id) 时，没有模型绑定干扰，缓存正常写入，因此后续 API 请求恰好命中了该缓存——造成“只有 Tinker 触发才有效”的错觉。
✅ 正确做法：显式接收 ID，延迟查询 + 缓存
修改控制器方法签名，禁止自动绑定，改为接收原始 ID，并在缓存闭包中完成查询：
/**
* Display the specified resource.
*
* @param int $application // 接收 ID，非模型实例
* @return \Illuminate\Http\Response
*/
public function show($application)
{
$cachedApp = Cache::store('redis')->remember(
"application:{$application}",
now()->addMinutes(30),
function () use ($application) {
return Application::with([
'payday', 'response', 'apiLinks'
])->findOrFail($application); // 使用 findOrFail 避免 null，更健壮
}
);
return response()->json(['application' => $cachedApp], 200);
}⚠️ 注意事项：
- 路由定义无需改动（如 Route::get('applications/{application}', [AppController::class, 'show']) 保持不变），但控制器方法参数必须移除类型提示 Application；
- 若需保留类型安全提示，可添加 PHPDoc 注释：/** @param int $application */；
- 使用 findOrFail() 替代 find()->first()，避免因链式调用引发意外行为（find($id) 本身已返回单个模型）；
- 缓存 key 中的 $application 是整数 ID，确保唯一性与可序列化（避免对象 toString 导致 key 异常）；
- 确保 APP_KEY 和 REDIS_* 环境配置正确，且 CACHE_DRIVER=redis 已启用。
? 验证缓存是否生效
可通过以下方式快速验证：
- 查看 Redis 中是否存在对应 key：redis-cli keys "application:*"；
- 在闭包内添加日志：Log::info('Cache miss, querying DB for app ID: ' . $application); —— 正常情况下，仅首次请求应输出该日志；
- 使用 Laravel Telescope 或 php artisan tinker 手动测试：Cache::store('redis')->get('application:123')。
遵循此模式，即可让 Redis 缓存真正作用于高频读取场景，将 8 秒响应降至毫秒级，同时保持代码清晰与可维护性。
