개발 노트/ASP.NET Core

HttpClient 재시도가 같은 요청을 두 번 처리하게 만들 때

Roslyn 2026. 11. 21. 08:00
반응형

외부 알림 서비스에 발송 작업을 등록했는데 응답을 기다리다 시간 초과가 났습니다. 다시 요청하니 이번에는 성공했습니다. 그런데 같은 알림이 두 번 발송됩니다. 처음 요청은 상대 서버에 반영되었고 응답만 돌아오지 않은 상황일 수 있습니다. 이 예시는 실제 장애 기록이 아닌 가상 사례입니다.

클라이언트에 재시도를 붙이면 일시적인 연결 문제를 견디는 데 도움이 될 수 있습니다. 그러나 읽기와 변경을 구분하지 않은 재시도는 실패를 줄이는 대신 중복 작업을 늘릴 수도 있습니다. 서비스 운영에서 필요한 질문은 몇 번 다시 보낼지보다 같은 요청을 다시 보내도 되는지입니다.

이 글은 2026년 11월 1일 확인한 Microsoft 문서와 HTTP 표준을 기준으로 외부 호출 정책을 정리합니다. 패키지 검토 기준은 Microsoft.Extensions.Http.Resilience 10.0.0이며 최신 버전 추천이나 실행 검증은 아닙니다. 실제 적용에서는 사용하는 패키지 버전과 외부 API 계약을 함께 확인해야 합니다.

응답을 못 받았다는 사실과 처리되지 않았다는 사실은 다릅니다

요청은 클라이언트에서 출발해 상대 서버에서 처리되고 응답으로 돌아옵니다. 실패가 어느 지점에서 생겼는지에 따라 결과가 달라집니다. 요청이 도착하기 전 끊겼다면 처리되지 않았을 수 있지만, 상대 서버가 등록을 마친 뒤 응답 경로가 끊겼다면 이미 작업은 존재할 수 있습니다.

따라서 시간 초과를 곧바로 등록 실패로 표시하고 새 등록을 반복하는 흐름은 주의해야 합니다. 응답을 받지 못한 상태를 결과 미확정으로 표현할 필요가 있습니다. 사용자가 다시 누르기 전에 기존 작업의 상태를 조회할 수 있는지, 운영자가 어떤 식별자로 확인할지부터 정합니다.

HTTP 표준의 멱등성 설명은 같은 요청을 반복했을 때 의도한 서버 효과가 한 번 수행한 경우와 같은지를 기준으로 삼습니다. 비멱등 요청은 실제 동작이 멱등적임을 알거나 이전 요청이 반영되지 않았음을 확인할 수 있는 등의 조건 없이 자동 재시도하지 않도록 설명합니다.

여기서 같은 응답 문자열이 돌아온다는 뜻으로 좁히면 안 됩니다. 삭제 요청을 반복했을 때 응답 상태가 달라져도 의도한 결과는 해당 자원의 삭제일 수 있습니다. 반대로 매번 성공 응답이 와도 알림 등록이 두 개 생긴다면 업무 결과는 중복입니다. 재시도 판단은 화면의 성공 표시보다 실제 효과를 중심으로 해야 합니다.

표준 처리기의 기본값을 업무 정책으로 착각하지 않습니다

Microsoft의 HTTP 복원력 문서는 AddStandardResilienceHandler가 여러 전략을 묶는 방법이라고 설명합니다. 같은 문서는 기본적으로 모든 HTTP 메서드에 재시도가 적용되며, POST로 레코드를 추가하는 상황에서 중복이 생길 수 있다고 경고합니다. 기본 설정이 있다는 사실은 모든 업무 요청에 적합하다는 뜻이 아닙니다.

처음 적용할 때는 조회용 클라이언트와 변경용 클라이언트의 정책을 나누는 구성을 검토할 수 있습니다. 한 서비스의 모든 호출이 같은 주소로 향하더라도 작업의 의미가 다를 수 있습니다. 목록 조회와 발송 등록을 같은 재시도 정책에 넣기 전에 각 요청의 결과와 실패 처리 방법을 적습니다.

문서의 DisableForUnsafeHttpMethods는 POST, PATCH, PUT, DELETE, CONNECT 재시도를 제외하는 선택지입니다. 여기서 unsafe는 읽기 전용 의미가 아니라는 분류입니다. PUT과 DELETE는 HTTP 표준에서 멱등 메서드로 분류되므로 안전성과 멱등성을 같은 말로 읽으면 안 됩니다. 이 설정은 변경 요청을 보수적으로 제외하는 출발점으로 이해할 수 있습니다.

그렇다고 GET이라는 이름만 보고 실제 서비스의 모든 부작용이 없다고 단정하지는 않습니다. 외부 API가 명세대로 동작하는지, 호출에 비용이나 사용량 제한이 있는지 확인해야 합니다. 메서드 분류는 중요한 단서지만 공급자의 동작 계약을 읽는 일을 대신하지 않습니다.

설정 위치도 확인합니다. 공통 HttpClient 기본 설정에 이미 처리기가 등록되어 있는데 개별 클라이언트에 다시 붙이면 정책을 파악하기 어려워질 수 있습니다. 공식 문서도 복원력 처리기를 무심코 중첩하지 않도록 안내합니다. 재시도 책임을 어떤 계층에 둘지 먼저 정하고 실제 등록 경로를 대조하는 편이 낫습니다.

변경 요청은 중복 식별과 결과 조회를 함께 설계합니다

외부 API가 멱등 키를 지원한다면 해당 규칙을 읽고 적용 여부를 판단합니다. 키를 보냈다는 사실만으로 자동으로 보호되는 것은 아닙니다. 공급자가 어느 요청에 지원하는지, 같은 키와 다른 내용이 오면 어떻게 처리하는지, 기록을 얼마나 유지하는지 확인해야 합니다. 지원하지 않는 API에 임의의 헤더를 붙여도 같은 계약이 생기지는 않습니다.

가상 알림 등록에서 한 번의 업무 요청에는 하나의 식별자를 배정한다고 해 보겠습니다. 결과가 불확실해서 같은 작업을 재확인하는 동안에는 그 식별자를 유지하는 흐름을 검토합니다. 네트워크 재전송마다 새 식별자를 만들면 상대가 각각 새 작업으로 인식할 수 있습니다. 반대로 실제로 새 알림을 요청할 때 이전 식별자를 재사용하는 것도 잘못된 결과를 만들 수 있습니다.

공급자가 제공하는 상태 조회 경로가 있다면 등록 요청과 연결합니다. 등록 응답에만 식별자가 담겨 있다면 그 응답을 못 받은 상황에서 무엇으로 조회할 수 있는지도 질문해야 합니다. 클라이언트 지정 식별자나 조회 조건을 지원하는지 확인하고, 없으면 결과 미확정 상태를 사람이 확인하는 절차까지 남깁니다.

내부 기록도 요청 횟수와 업무 건수를 나눕니다. 업무 한 건이 전송 두 번을 거쳐 성공했다면 이를 업무 두 건으로 표시해서는 안 됩니다. 운영 화면에는 업무 식별자, 마지막 확인 상태, 전송 시각과 횟수를 연결하되 실제 수신자나 인증 토큰을 불필요하게 로그에 노출하지 않는 방식으로 구성합니다.

사용자에게 보여 줄 문구도 중요합니다. 결과를 알 수 없는데 실패라고 단정하면 사용자는 같은 작업을 다시 만들 수 있습니다. 처리 결과를 확인하고 있다는 안내와 함께 추가 제출이 무엇을 의미하는지 설명합니다. 중복 위험을 버튼 비활성화 하나로 해결하려고 하지 말고 서버의 작업 식별과 복구 경로까지 연결해야 합니다.

재시도 횟수보다 전체 시간과 중단 조건을 먼저 정합니다

재시도는 기다림과 추가 요청을 동반합니다. 공식 처리기는 전체 작업 시간 제한과 개별 시도 시간 제한을 구분합니다. 화면에서 사용자가 기다릴 수 있는 시간, 외부 API의 제한, 백그라운드 작업으로 넘길 수 있는지를 함께 고려해야 합니다. 각 시도를 짧게 했다고 전체 작업도 반드시 짧아지는 것은 아닙니다.

가상 정책으로 세 번까지 시도한다고 적을 때도 최초 요청을 포함한 총 횟수인지 추가 재시도 횟수인지 명확히 해야 합니다. 한 계층에서의 횟수만 보고 실제 전송량을 계산하지 않습니다. SDK와 애플리케이션이 각각 재시도한다면 요청이 예상보다 늘 수 있으므로 어느 계층이 책임지는지 확인합니다.

  • 재시도 대상: 어떤 오류와 요청을 다시 보낼지, 변경 요청을 제외할 조건은 무엇인지 적습니다.
  • 결과 불확실: 응답만 유실된 경우 기존 작업을 찾을 식별자와 조회 경로를 정합니다.
  • 시간 예산: 개별 시도와 전체 작업, 사용자 취소가 각각 어디에서 적용되는지 확인합니다.
  • 중단 이후: 자동 시도가 끝난 뒤 실패 확정과 결과 미확정을 어떻게 구분하고 복구할지 적습니다.

검증은 실제 발송이나 결제 같은 효과가 없는 대역 환경에서 계획합니다. 요청을 반영하기 전 실패, 반영 후 응답 유실, 지연 응답, 사용자 취소를 나눠 어떤 상태가 남는지 볼 수 있습니다. 이 글에서는 해당 실험을 실행하지 않았습니다. 정상 응답 한 번만 확인하고 중복 안전성이 검증되었다고 보고하지 않는 것이 핵심입니다.

오늘은 외부 변경 요청 하나를 골라 같은 요청을 두 번 보냈을 때 무엇이 생기는지 문서로 답해 보시면 됩니다. 답이 불확실하면 자동 재시도부터 넓히지 말고 공급자 계약과 결과 조회 방법을 확인합니다. 재시도는 통신을 반복하는 기능이며, 한 번의 업무를 보존하는 책임은 요청의 의미와 복구 설계에 남아 있습니다.

반응형