Route::get('api/posts/{post}') 404 是因隐式模型绑定失败且未匹配其他路由：URL 参数值在数据库中不存在、控制器未声明 Post $post 类型提示、主键名或类型不匹配（如 uuid 未设 $keyType='string'）、未加 api 中间件和 /api 前缀，或 Accept 头非 application/json。
为什么 Route::get('api/posts/{post}') 会 404？
不是路由没注册，而是 Laravel 默认对模型绑定启用「隐式路由模型绑定」，但前提是 {post} 对应的 URL 参数值必须能查到真实记录。如果传了不存在的 ID（比如 /api/posts/999999），Laravel 不会抛 404 给你——它先尝试找模型，找不到就直接跳过该路由，去匹配下一个，最终落到全局 404。
- 检查是否在控制器方法签名里写了
Post $post：这是触发隐式绑定的关键，没写就不会走绑定逻辑 - 确认数据库里真有对应 ID 的记录；用
php artisan tinker手动查App\Models\Post::find(999999)看返回是否为 null - 如果想让找不到时也进控制器处理（比如统一返回错误格式），改用显式绑定：
Route::get('api/posts/{post}', [PostController::class, 'show'])->whereNumber('post');，并在方法里手动Post::findOrFail($post)
Route::apiResource() 没生效？检查中间件和前缀
Laravel 的 API 路由默认不自动加载 api 中间件组，也不带 /api 前缀——哪怕你把它写在 routes/api.php 里。所以 Route::apiResource('posts', PostController::class) 实际注册的是 /posts，不是 /api/posts，且没有做频率限制、CSRF 排除等 API 特需处理。
- 确保
routes/api.php被正确加载：检查app/Providers/RouteServiceProvider.php中mapApiRoutes()是否被调用，且路径指向正确文件 - 给所有 API 路由加统一前缀和中间件：
Route::middleware('api')->prefix('api')->group(function () { Route::apiResource('posts', PostController::class); }); - 别把 API 路由写进
routes/web.php：那里默认套web中间件，含 session 和 CSRF，API 请求会因缺少 token 直接 419 或 403
模型绑定失败却没报错？可能是主键名或类型不匹配
隐式绑定默认按模型的 $primaryKey（通常是 id）和类型（整型）去匹配 URL 参数。如果你的表主键叫 uuid，或者用字符串 UUID，又或者用了复合主键，Laravel 就无法自动解析，静默跳过绑定，导致控制器收到的是原始字符串参数而非模型实例，后续调用 $post->title 就会报 Call to a member function title() on string 这类错误。
- 检查模型类里的
protected $primaryKey = 'uuid';和protected $keyType = 'string';是否设置正确 - 如果主键非数字，必须在路由中声明约束：
->whereUuid('post')或->where('post', '[a-f0-9-]+') - 不要在模型里重写
getRouteKeyName()后忘记同步更新数据库字段名；比如返回'slug'，但 URL 传的是/api/posts/123，就会查slug = '123'，自然找不到
调试时 curl 返回 404，但 php artisan route:list 显示路由存在
最常见原因是请求方式或 Accept 头不对。Laravel API 路由默认只响应 Accept: application/json，如果用浏览器直接访问或没设 header，它可能 fallback 到 web 路由，或被中间件拦截后返回 HTML 404 页面（状态码仍是 404，但内容是视图）。
- 用 curl 测试时务必带上头：
curl -H "Accept: application/json" http://localhost:8000/api/posts/1 - 检查
config/app.php中debug是否为 true：false 时很多错误会被吞掉，只留 404；开启后能看到更具体的异常信息 - 运行
php artisan route:list --name=posts.show确认该路由确实注册成功，注意看 Method 列是否为 GET，URI 列是否含/api前缀
模型绑定和路由注册看似简单，但实际卡点都在「默认行为」和「配置偏差」之间——比如你以为写了 apiResource 就自动带前缀，其实要自己包一层；你以为传个 ID 就能绑上模型，其实主键类型不对就直接失效。这些地方不会报错，只会默默 404。
