HTTP 301 Moved Permanently: 의미

이 오류의 의미와 확인 방법

• 브라우저, API 클라이언트, 모니터링 서비스 또는 HTTP 검사기가 301 Moved Permanently를 보고합니다.
• 브라우저가 리디렉션을 자동으로 따라가 다른 URL을 표시하거나, 대상이 원래 URL로 되돌아가면 리디렉션 루프를 표시할 수 있습니다.
• 응답에 리디렉션 대상이 포함된 Location 헤더가 있을 수 있습니다.
• 이 동작은 하나의 URL, 호스트 이름, HTTP 메서드, 인증 상태, 사용자 에이전트 또는 네트워크 경로에서만 발생할 수 있습니다.
• 엔드포인트가 HTTP 응답을 반환했기 때문에 DNS는 정상적으로 확인되고 TLS도 성공적으로 완료될 수 있습니다.
• 리디렉션 설정에 따라 API 클라이언트나 자동화 도구가 301에서 중단되고 리디렉션을 따라가지 않을 수 있습니다.

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

1. 의도한 URL 표준화: 사이트가 대체 호스트 이름, 경로, 후행 슬래시 형식 또는 다른 URL 변형을 선호하는 주소로 리디렉션합니다.
2. 프로토콜 또는 호스트 이름 마이그레이션: HTTP 트래픽을 HTTPS로 리디렉션하거나, 이전 호스트 이름을 대체 호스트 이름으로 연결할 수 있습니다.
3. 애플리케이션 또는 프레임워크 라우팅: 경로 변경, 로그인 상태 변경 또는 리소스 이전 후 애플리케이션이 경로를 리디렉션할 수 있습니다.
4. 웹 서버, 리버스 프록시 또는 CDN 규칙: 인프라 설정이 요청을 애플리케이션에 전달하기 전에 리디렉션을 적용할 수 있습니다.
5. 캐시된 리디렉션 동작: 설정 변경이 전파되는 동안 브라우저, 중간 캐시 또는 CDN이 이전에 캐시된 리디렉션을 계속 제공할 수 있습니다.
6. 메서드별 동작: 브라우저 탐색에는 적절하지만 API 요청이나 요청 의미를 보존해야 하는 메서드에는 적합하지 않은 리디렉션 규칙일 수 있습니다.
7. 예상하지 못했거나 충돌하는 규칙: 여러 계층이 서로 다른 대상으로 리디렉션하여 체인이나 루프를 만들 수 있습니다.

해결 방법

사이트를 방문하는 경우

1. 호스트 이름, 경로 및 프로토콜을 포함한 정확한 주소를 확인하세요. 대상이 익숙하고 예상한 주소일 때만 리디렉션을 따라가세요.
2. 대상에 계정이 필요한 경우 사이트의 일반적인 인터페이스를 통해 로그인한 후 다시 시도하세요. 익숙하지 않은 리디렉션 도메인에 인증 정보를 입력하지 마세요.
3. 브라우저가 의도한 페이지에 도달한다면 301이 정상적으로 작동하는 것일 수 있습니다. 루프가 발생하거나 잘못된 호스트로 이동하거나 존재하지 않는 페이지에서 끝나면 원래 URL과 대상을 기록하세요.
4. API 또는 자동화 클라이언트의 경우 리디렉션을 따라가도록 설정되어 있는지, 리디렉션된 URL이 동일한 요청 메서드와 인증 컨텍스트에서 유효한지 확인하세요.
5. 원래 URL, 대상, 대략적인 시간, 클라이언트 유형 및 확인된 상태를 사이트 운영자에게 전달하세요. 비밀번호, 쿠키 또는 API 시크릿은 공유하지 마세요.

사이트를 소유하거나 운영하는 경우

1. 정확히 동일한 요청을 재현하세요. HTTP 메서드, 전체 URL, 호스트, 프로토콜, 관련된 경우 인증 상태, 최종 상태 및 각 리디렉션 대상을 기록하세요.
2. 특히 Location, 캐시 관련 헤더, 인증 관련 헤더 및 프록시나 서버 계층을 식별하는 헤더를 포함해 응답 헤더를 확인하세요.
3. 애플리케이션, 웹 서버, 리버스 프록시, CDN 또는 WAF 중 어느 구성 요소가 301을 생성했는지 파악하세요. 요청 시간과 가능한 경우 요청 ID를 사용해 해당 로그를 확인하세요.
4. 의도한 라우팅 설계와 동작을 비교하세요. 호스트 이름 변경, HTTP-to-HTTPS 정책, 표준 경로, 이전된 리소스 또는 애플리케이션 흐름을 처리하기 위한 리디렉션인지 확인하세요.
5. 리디렉션 체인, 루프, 충돌하는 규칙 및 잘못된 대상을 확인하세요. 최근 배포와 라우팅, 인증, 캐싱, 프록시 또는 CDN 설정 변경을 검토하세요.
6. 응답을 생성한 계층에서 권한이 부여된 가장 제한적인 수정만 적용하세요. 하나의 경로나 조건이 잘못된 경우 광범위한 권한, 보안 또는 리디렉션 규칙을 변경하지 마세요.
7. 적절한 클라이언트에서 동일한 URL과 메서드로 다시 테스트하세요. 그런 다음 대상, 중요한 관련 경로 및 관련된 인증·비인증 사례를 테스트하세요.
8. 캐시된 리디렉션이 의심되면 승인된 사이트 캐시 무효화 절차를 따르고, 변경 전에 그 운영상 영향을 고려하세요.

예방 및 해결 확인 방법

• 이전 URL, 대상, 영향을 받는 메서드 및 담당자를 포함해 의도한 리디렉션을 정의하고 문서화하세요.
• 지원되는 경우 웹 서버, 애플리케이션, 리버스 프록시, CDN 및 WAF 규칙을 버전 관리하세요.
• 릴리스 후 표준 URL, HTTP-to-HTTPS 동작, 호스트 이름 변경, 중요한 API 메서드 및 인증 경로를 테스트하세요.
• 모든 301을 장애로 간주하지 말고 경로 및 배포별 리디렉션 비율, 체인 및 루프를 모니터링하세요.
• 예상하지 못한 리디렉션을 대조할 수 있도록 요청 및 인프라 로그를 충분히 오래 보관하세요.
• 리디렉션 규칙을 변경할 때 캐시 동작을 검토하여 오래된 응답이 수정 결과를 가리지 않도록 하세요.

자주 묻는 질문