🔄 PUT과 PATCH가 같은 줄 알았는데… 틀렸다

Source: Dev.to

🧠 왜 이 HTTP 메서드들이 중요한가

REST API에서 HTTP 메서드는 단순한 문법이 아니다.
이들은 다음을 정의한다:

• API 동작
• 클라이언트 기대치
• 데이터 무결성
• 오류 처리

잘못된 메서드를 사용하면 API가 혼란스럽고, 신뢰할 수 없으며, 유지 보수가 어려워진다.

✏️ PUT 매핑 — 전체 업데이트

PUT은 전체 리소스를 교체하고 싶을 때 사용한다.

핵심 아이디어:
PUT은 전체 객체를 기대한다, 부분 데이터가 아니다.

필드가 누락되면:

• 해당 필드가 덮어써질 수 있다
• 혹은 의도치 않게 초기화될 수 있다

그래서 PUT은 신중하게 사용해야 한다.

🧩 PATCH 매핑 — 부분 업데이트

PATCH는 특정 필드만 업데이트하고 싶을 때 사용한다.

핵심 아이디어:
PATCH는 제공된 부분만 수정하고 나머지는 그대로 둔다.

다음과 같은 경우에 매우 유용하다:

• 단일 필드만 업데이트할 때
• 실수로 데이터 손실을 방지하고 싶을 때
• 유연한 API를 설계하고 싶을 때

이 차이를 이해하고 나니 업데이트 API가 이상하게 동작하던 문제가 사라졌다.

🗑️ DELETE 매핑 — 리소스 삭제

DELETE는 시스템에서 리소스를 제거할 때 사용한다.

간단해 보이지만, 여기서 많은 초보자(나 포함)가 실수한다.

흔한 실수:

• 리소스가 존재하지 않아도 항상 성공을 반환한다

좋은 DELETE API는 다음을 해야 한다:

• 리소스 존재 여부를 확인한다
• 의미 있는 응답을 반환한다
• 오류를 우아하게 처리한다

DELETE는 단순히 데이터를 삭제하는 것이 아니라 올바른 API 동작을 보장하는 것이다.

⚠️ 내가 저지른 실수

나는 이전에:

• 모든 곳에 PUT을 사용했다
• PATCH를 완전히 무시했다
• DELETE를 단순한 더미 작업으로 취급했다

데모에서는 동작했지만 실제 프로젝트에서는 실패했다.
각 메서드 뒤에 있는 의도를 이해하면서 API 설계 방식이 바뀌었다.

✅ 올바르게 적용한 뒤 변화

이 매핑들을 올바르게 사용하고 나니:

• API가 예측 가능해졌다
• 클라이언트가 응답을 신뢰하게 되었다
• 버그가 감소했다
• 코드가 전문적으로 느껴졌다

이때부터 Spring Boot API가 프로덕션 수준으로 다가왔다.

🚀 마무리 생각

PUT, PATCH, DELETE는 간단해 보이지만 잘못 사용하면 문제가 된다.

Spring Boot을 배우면서 API가:

• 불명확하고
• 일관성이 없으며
• 디버깅이 어려울 때

여기서 시작하라. 이 이해는 백엔드 개발자가 되기 위한 큰 발걸음이다.