HTTP 505 HTTP Version Not Supported: 의미와 해결 방법

이 오류의 의미와 확인 방법

• 브라우저, API 클라이언트, 모니터링 시스템 또는 명령줄 도구가 505 HTTP Version Not Supported를 수신합니다.
• 응답에 요청된 HTTP 버전이 지원되지 않는다는 메시지가 포함될 수 있습니다.
• 클라이언트가 이후 HTTP 응답을 수신했으므로 DNS가 성공적으로 해석되고 TLS가 성공적으로 완료될 수 있습니다.
• 특정 클라이언트, 프로토콜 협상 경로, URL, HTTP 메서드 또는 중간 계층에서만 오류가 발생할 수 있습니다.
• 응답 헤더를 통해 응답이 proxy, CDN, load balancer 또는 origin server에서 왔는지 확인할 수 있으며, 캐싱 또는 연결 세부 정보가 표시될 수도 있습니다.

가능성이 높은 순서의 주요 원인

1. 지원되지 않는 HTTP 프로토콜 버전: 엔드포인트가 요청에 사용된 주요 HTTP 버전을 지원하지 않습니다. 이것이 상태 코드 505의 정의상 원인입니다.
2. 중간 계층과 upstream 간 프로토콜 불일치: reverse proxy, CDN, load balancer 또는 gateway가 다음 서버에서 허용하지 않는 프로토콜 버전을 사용하거나 자체적으로 505 응답을 반환할 수 있습니다.
3. 잘못되었거나 불완전한 HTTP 프로토콜 설정: 최근 서버, proxy 또는 애플리케이션 변경으로 인해 전체 요청 경로에서 지원되지 않는 프로토콜 버전이 활성화되었거나 필수로 지정되었을 수 있습니다.
4. 클라이언트별 협상 또는 요청 동작: 특정 클라이언트나 모니터링 도구가 브라우저 또는 다른 클라이언트와 다른 HTTP 프로토콜을 선택하여 호환성 문제를 드러낼 수 있습니다.
5. origin이 아닌 계층에서 발생한 예상치 못한 응답: 상태 코드는 URL을 소유한 애플리케이션이 아니라 gateway 또는 보안 중간 계층에서 생성되었을 수 있습니다. 이를 origin server의 응답과 구분하려면 헤더와 로그를 확인해야 합니다.

인증, rate limit, DNS 및 TLS가 요청에 영향을 줄 수 있지만, 그 자체만으로는 HTTP 505 응답을 설명할 수 없습니다. 응답 헤더 또는 로그에서 프로토콜 버전 실패와의 연관성이 확인되지 않는 한 별도의 조사 경로로 다루세요.

해결 방법

방문자 및 API 사용자

1. 정확한 URL을 한 번 다시 요청하고, 클라이언트가 최신 상태이며 일반적인 HTTP 요청을 보내도록 설정되어 있는지 확인하세요.
2. API 클라이언트 또는 모니터링 도구에서 문제가 발생한다면, 지원되는 다른 클라이언트와 결과를 비교하세요. 실패가 특정 클라이언트에 한정되는지 기록하세요.
3. URL, HTTP 메서드, 대략적인 시각, 응답 상태 및 응답 헤더를 기록하세요. 비밀번호, 쿠키, 인증 토큰 또는 기타 비밀 정보는 포함하지 마세요.
4. 오류가 계속되면 정제한 해당 정보를 사이트 또는 API 운영자에게 보내세요. 방문자가 서버 측 프로토콜 호환성 문제를 직접 해결할 수 있는 경우는 일반적으로 드뭅니다.

개발자 및 사이트 운영자

1. 정확한 요청을 수집하세요. 호스트 이름, 경로, 메서드, 요청 프로토콜, 클라이언트, 타임스탬프 및 최종 상태를 기록하세요. 응답이 실제로 505인지, 아니면 redirect 또는 다른 실패 이후 클라이언트가 표시한 상태인지 확인하세요.
2. 프로토콜 협상을 확인하세요. 클라이언트가 사용했거나 사용하려고 한 HTTP 버전과 엔드포인트, proxy, load balancer 또는 CDN이 지원하는 버전을 확인하세요. 암호화된 연결의 경우 도구에서 확인할 수 있다면 협상된 application protocol을 검토하세요.
3. 응답 계층을 식별하세요. 응답 헤더, 확인 가능한 경우의 서버 식별 정보, 요청 식별자 및 access log를 사용하여 505가 CDN, WAF, gateway, reverse proxy, 웹 서버 또는 애플리케이션에서 발생했는지 확인하세요.
4. 로그를 대조하세요. 식별된 계층과 upstream 계층에서 동일한 타임스탬프, 경로, 메서드, 클라이언트 및 요청 ID를 검색하세요. origin 로그가 없다면 중간 계층이 요청을 전달하기 전에 거부했을 가능성이 있습니다.
5. 최근 프로토콜 변경을 검토하세요. HTTP 버전 지원, proxy-to-origin 연결, load balancer listener, gateway 라우팅 및 클라이언트 또는 모니터링 설정에 영향을 준 최근 배포와 설정 변경을 확인하세요.
6. 권한이 부여된 최소 범위의 수정만 적용하세요. 영향을 받은 클라이언트, 중간 계층 및 origin이 전체 요청 경로에서 지원되는 프로토콜 버전을 사용하도록 조정하세요. 우회 방법으로 TLS 검증, 인증 또는 보안 제어를 비활성화하지 마세요.
7. 동일한 요청을 다시 테스트하세요. 원래 URL과 메서드를 확인한 다음 대표적인 경로와 프로토콜 경로를 테스트하세요. 수정으로 인해 관련 없는 상태 코드나 라우팅 동작이 변경되지 않았는지 확인하세요.
8. 공유 인프라에는 통제된 rollout을 사용하세요. 영향을 받는 설정이 여러 사이트나 경로에 적용된다면 전체에 적용하기 전에 승인된 staging 환경 또는 제한된 범위의 변경으로 테스트하세요. 해당 환경의 변경 및 rollback 절차를 따르세요.

예방 및 해결 확인 방법

• 각 요청 경로에서 클라이언트, gateway, proxy, load balancer 및 origin이 지원하는 HTTP 버전을 문서화하세요.
• 프로토콜 또는 인프라 변경 후 실제 운영 환경과 유사한 proxy 및 CDN 경로를 통해 중요한 브라우저 경로와 API 메서드를 테스트하세요.
• 경로, 클라이언트 유형, 프로토콜 및 배포별로 상태 코드를 모니터링하여 클라이언트별 505 응답을 확인할 수 있도록 하세요.
• proxy, load balancer, 웹 서버 및 애플리케이션 설정을 테스트된 rollback 경로와 함께 버전 관리하세요.
• 예상치 못한 응답을 생성한 계층을 식별할 수 있도록 상관 관계가 있는 access log와 gateway log를 충분히 오래 보관하세요.
• 모니터링 도구와 API 클라이언트를 최신 상태로 유지하고, 도입 또는 설정 변경 시 프로토콜 설정을 검증하세요.

자주 묻는 질문