Laravel DELETE API无法正常删除数据问题求助

我使用Laravel框架开发JSON格式的REST API，尝试通过PHP调用Laravel的路由API执行删除操作，但功能无法正常运行。请求地址为http://localhost:8000/api/subject/13，运行时无代码报错，但执行后无任何效果。相关代码如下：

Laravel路由 #

Route::delete('/subject/{id}', [SubjectController::class, 'deleteSubject']);

控制器代码 #

public function deleteSubject($id)
{
    $subject = Subject::find($id);

    if (!$subject) {
        return response()->json(['message' => 'Subject not found'], 404);
    }

    $subject->delete();

    return response()->json(['message' => 'Subject deleted successfully'], 200);
}

排查步骤与解决方法 #

• 确保请求方法为DELETE
  PHP发起请求时默认多为GET/POST，必须明确指定请求方法为DELETE。比如用cURL时需设置：

  $ch = curl_init('http://localhost:8000/api/subject/13');
  curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
  // 其他cURL配置...
  curl_exec($ch);
  

  用Postman测试时，要选择DELETE请求方法。

• 检查路由前缀与文件位置
  若路由定义在routes/web.php，则实际请求地址无需/api前缀；若在routes/api.php，Laravel默认会自动添加/api前缀，需确认路由文件位置与请求地址匹配。

• 验证目标ID的记录存在性
  先确认数据库中是否存在ID为13的Subject记录。若记录不存在，控制器会返回404响应，可通过打印请求返回结果或用Postman查看响应内容确认。

• 排查软删除影响
  如果Subject模型使用了SoftDeletes trait，delete()方法仅会标记deleted_at字段而非物理删除。需物理删除的话改用$subject->forceDelete()；若需查看软删除记录，查询时需添加withTrashed()。

• CSRF令牌验证（针对web路由）
  若路由在routes/web.php中，Laravel会强制验证CSRF令牌，未携带令牌的DELETE请求会被拦截。解决方式：将路由移至routes/api.php（api路由组默认关闭CSRF验证），或在请求中携带_token参数。

• 查看Laravel日志
  即使无代码报错，可查看storage/logs/laravel.log文件，排查是否存在数据库连接、权限等隐藏错误。

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