Laravel API中::put与::delete方法异常：返回404而非JSON响应

核心原因 #

你遇到的问题本质是Laravel隐式路由模型绑定的异常默认返回HTML页面，而非你控制器中定义的JSON响应。当路由中的{badge}参数找不到对应模型时，Laravel会直接抛出ModelNotFoundException，并返回默认的HTML 404页面，根本不会进入你控制器的update或destroy方法，所以你写的if (!$badge->exists)判断完全没执行。

而你用POST方法能正常返回JSON，是因为POST路由大概率是手动通过Badge::find($id)查找模型，此时找不到模型时的逻辑由你自己控制，所以能返回预期的JSON。

解决方案 #

1. 让API请求的404返回JSON格式 #

修改异常处理器，让API请求遇到模型不存在的情况时返回JSON响应：

打开app/Exceptions/Handler.php（Laravel 9+版本请关注register方法中的异常逻辑），添加以下处理：

use Illuminate\Database\Eloquent\ModelNotFoundException;
use Illuminate\Http\Request;

// Laravel 8及以下版本，在render方法中添加
public function render($request, Throwable $exception)
{
    if ($request->is('api/*') && $exception instanceof ModelNotFoundException) {
        return response()->json([
            'message' => 'Badge not found.'
        ], 404);
    }

    return parent::render($request, $exception);
}

// Laravel 9+版本，在register方法中添加
public function register()
{
    $this->renderable(function (ModelNotFoundException $e, Request $request) {
        if ($request->is('api/*')) {
            return response()->json([
                'message' => 'Badge not found.'
            ], 404);
        }
    });
}

2. 确认路由模型绑定的正确性 #

• 检查Badge模型的主键是否为默认的id：如果你的表用了其他字段作为主键（比如uuid），需要在模型中声明：

  class Badge extends Model
  {
      protected $primaryKey = 'uuid';
      public $incrementing = false; // 非自增主键需添加此配置
  }
  

• 如果路由绑定用的不是主键，而是其他字段（比如slug），需要在模型中指定路由键：

  class Badge extends Model
  {
      public function getRouteKeyName()
      {
          return 'slug';
      }
  }
  

• 确认Postman请求的URL参数正确：比如请求PUT /api/badges/1时，1确实是badges表中存在的主键值。

3. 可选：关闭隐式模型绑定的自动404（不推荐） #

如果你想完全自己控制模型不存在的逻辑，可以显式查找模型，放弃隐式绑定：

修改路由：

Route::put('/badges/{badgeId}', [BadgeController::class, 'update']);

修改控制器方法：

public function update(StoreBadgeRequest $request, $badgeId): JsonResponse
{
    $badge = Badge::find($badgeId);
    if (!$badge) {
        return new JsonResponse([
            'message' => 'Badge not found.'
        ], Response::HTTP_NOT_FOUND);
    }

    // 后续权限检查和更新逻辑保持不变
}

这种方式虽能完全控制逻辑，但失去了隐式模型绑定的便利性，更推荐第一种方案。

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