HTTP 400번대 에러 정리 및 추천 메시지

400 Bad Request

POST /api/comment HTTP/1.1
Content-Type: application/json

{
  "nickname": "홍길동"
  // "content" 필드가 없음 → 서버는 400 반환
}Copy

if (!$request->has('content')) {
    return response('댓글 내용은 필수입니다.', 400);
}Copy

401 Unauthorized

POST /api/comment HTTP/1.1
Authorization: 

{
  "content": "좋은 글 감사합니다!"
}
// Authorization 헤더가 없음 → 서버는 401 반환Copy

if (!auth()->check()) {
    return response('로그인이 필요합니다.', 401);
}Copy

403 Forbidden

PATCH /api/comment/123 HTTP/1.1
Authorization: Bearer xxxxxxx

{
  "content": "수정합니다."
}
// 로그인은 했지만 댓글의 작성자가 아님 → 서버는 403 반환Copy

if ($comment->user_id !== auth()->id()) {
    return response('해당 댓글에 대한 수정 권한이 없습니다.', 403);
}Copy

404 Not Found

GET /api/post/999999 HTTP/1.1Copy

$post = Post::find($id);
if (!$post) {
    return response('요청하신 게시글을 찾을 수 없습니다.', 404);
}Copy

405 Method Not Allowed

GET /api/comment/123Copy

Route::delete('/comment/{id}', 'CommentController@destroy');Copy

408 Request Timeout

POST /api/upload HTTP/1.1
... (요청 데이터가 너무 오래 전송되지 않음)
→ 서버: 408 Request TimeoutCopy

return response('요청 시간이 초과되었습니다. 다시 시도해주세요.', 408);Copy

409 Conflict

POST /api/register HTTP/1.1
Content-Type: application/json

{
  "email": "test@example.com",
  "password": "1234"
}
// 이 이메일은 이미 가입되어 있음 → 서버는 409 반환Copy

if (User::where('email', $request->email)->exists()) {
    return response('이미 등록된 이메일입니다.', 409);
}Copy

429 Too Many Requests

POST /api/comment HTTP/1.1
Authorization: Bearer xxxxxx

{
  "content": "좋은 글입니다"
}
// 이미 제한된 횟수 초과 → 서버는 429 반환Copy

Route::post('/api/comment', 'CommentController@add')->middleware('throttle:3,1');Copy

HTTP 500번대 에러 정리 및 해결 방안

지난 글에 이어서 이번에는 서버단에서 발생하는 문제에 대한 에러코드에 대해 알아보고자 한다.사실 400번대 에러는 클라이언트의 잘못된 요청이 대부분이므로 적당히 에러코드와 함께 메시지를 보여줘 UX를 충족시키면되지만, 500번대는 실제로 서버에서 백단작업중에 의도치 않게 발생하는 문제이므로 유저가 보는 경우...

https://erulabo.com/453