Laravel Blade访问指定ID文章页报404 (Not Found) 错误求助

404错误排查方向及解决方案 #

• 路由匹配顺序错误
  Laravel路由按定义顺序从上到下匹配，若/posts/{id}/view路由定义在同前缀的宽泛规则路由之后（例如前置了Route::get('/posts/{any}', ...)类路由），会被优先匹配到其他路由触发404。
  解决方法：将精准匹配的路由放在同前缀模糊匹配路由的上方，调整顺序后重新测试。
• 跳转链接属性未加引号导致解析异常
  视图层跳转代码href={{route('posts.view',$post->id)}}未给属性值加双引号，当生成的链接存在特殊字符、或浏览器解析异常时，会导致实际跳转地址和预期不符。
  解决方法：修改链接代码为href="{{route('posts.view',$post->id)}}"，给路由生成的地址包裹双引号。
• 路由模型绑定匹配失败
  若PostController的view方法使用了路由模型绑定，两种场景会触发404：
  1. 方法参数名与路由参数名不匹配：路由定义参数为{id}，若方法参数写为public function view(Post $post)，参数名不一致会导致绑定失败，若方法内自行查询数据为空也会返回404
  2. 对应ID的文章不存在/已被软删除：Laravel路由模型绑定查询不到对应数据时会自动返回404响应
     解决方法：
  3. 保持路由参数与控制器方法参数名一致，可将路由参数修改为{post}匹配方法参数，或修改方法定义为public function view(Post $id)
  4. 确认对应ID的文章数据是否存在，若需要包含软删除数据，可在路由定义中追加->withTrashed()，或在方法内手动查询时加入软删除数据的查询条件
• 路由缓存未更新
  若开启了路由缓存，修改路由规则后未更新缓存会导致新路由不生效。
  解决方法：执行php artisan route:clear清除路由缓存，生产环境可执行php artisan route:cache重新生成缓存。
• Web服务器伪静态配置异常
  若其他路由也偶发404，可能是Nginx/Apache的伪静态规则配置错误，无法将请求转发到Laravel入口文件。
  解决方法：检查Web服务器的Laravel伪静态配置，确保所有请求都被转发到public/index.php处理。

辅助排查技巧 #

可先执行命令php artisan route:list查看posts.view路由是否存在、对应的URI规则是否符合预期，再对比浏览器地址栏的实际跳转地址与路由规则是否匹配，快速定位问题。

内容的提问来源于stack exchange，提问作者Kaveh Mohammadi