如何解决Laravel API中的500内部服务器错误

我正在开发一个支持用户发布项目的Laravel API，已编写ProjectController的index方法实现项目列表的筛选、排序与分页功能，API路由通过auth:sanctum中间件保护。已向数据库填充测试项目，但用Postman访问http://localhost:8000/api/projects时出现500 Internal Server Error，请求协助排查解决。

我的ProjectController代码 #

public function index(Request $request): \Illuminate\Http\JsonResponse
{
    $query = Project::query();

    // 应用筛选条件
    if ($request->has('domain')) {
        $query->where('domain', $request->input('domain'));
    }
    if ($request->has('skills')) {
        $query->whereHas('skills', function ($query) use ($request) {
            $query->whereIn('name', explode(',', $request->input('skills')));
        });
    }
    if ($request->has('hourly_rate')) {
        $query->where('hourly_rate', '<=', $request->input('hourly_rate'));
    }
    if ($request->has('date_posted')) {
        $query->whereDate('created_at', '>=', Carbon::parse($request->input('date_posted'))->startOfDay());
    }

    // 排序结果
    if ($request->has('sort_by') && in_array($request->input('sort_by'), ['hourly_rate', 'created_at'])) {
        $sortOrder = $request->input('sort_order', 'desc');
        $query->orderBy($request->input('sort_by'), $sortOrder);
    }

    $projects = $query->paginate($request->input('per_page', 10));

    return response()->json($projects, 200);
}

我的API路由文件代码 #

Route::middleware('auth:sanctum')->group(function () {
//    Route::apiResource('users', UserController::class);

    Route::apiResource('projects', ProjectController::class);
    Route::apiResource('bids', BidController::class);
    Route::apiResource('messages', MessageController::class);
    Route::apiResource('reviews', ReviewController::class);
});

Route::post('/register', [RegisterController::class, 'register']);
Route::post('/login', [AuthController::class, 'login']);
Route::post('/logout', [AuthController::class, 'logout'])->middleware('auth:sanctum');

排查建议 #

• 查看Laravel日志：打开storage/logs/laravel.log查看具体错误信息，500错误的根因（比如模型关联缺失、日期解析失败、字段不存在等）都会在这里记录。
• 验证认证令牌：确认Postman请求头中是否正确携带了Sanctum的Authorization: Bearer {token}令牌，也可以临时注释路由的auth:sanctum中间件，测试是否能正常返回数据，排除认证环节问题。
• 检查模型关联：确认Project模型中已正确定义skills关联方法，比如：

  public function skills()
  {
      return $this->belongsToMany(Skill::class);
  }
  

  关联不存在会直接触发查询错误。
• 添加请求验证：在index方法开头添加参数验证，避免非法参数引发异常：

  $request->validate([
      'date_posted' => 'nullable|date',
      'hourly_rate' => 'nullable|numeric',
      'skills' => 'nullable|string',
      'sort_by' => 'nullable|in:hourly_rate,created_at',
      'sort_order' => 'nullable|in:asc,desc',
      'per_page' => 'nullable|integer|min:1|max:100',
  ]);
  

• 检查数据库字段：确认projects表存在domain、hourly_rate、created_at字段，且字段类型符合预期（比如hourly_rate为数值类型）。
• 逐步排查逻辑：暂时注释所有筛选、排序代码，只保留基础分页查询，确认能正常返回数据后，再逐步恢复逻辑定位问题点。

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