AWS Lambda에서 HTTP 502 및 HTTP 500 상태 코드(서버 측) 오류를 해결하려면 어떻게 해야 합니까?

최종 업데이트 날짜: 2021년 9월 9일

AWS Lambda 함수를 호출하려고 하면 502 또는 500 서버 측 오류와 함께 요청이 실패합니다. 이 오류를 해결하려면 어떻게 해야 합니까?

해결 방법

먼저, Lambda 호출 API 오류를 구체적으로 파악합니다. 그런 다음, 해당 오류에 대하여 제시된 문제 해결 단계를 따르세요.

참고: 발생 가능한 오류 및 그에 대한 설명 목록은 Lambda 호출 API 참조에서 오류 목록을 확인하세요.

CodeArtifactUserPendingException

함수가 Active 상태일 때만 함수에서 작동하는 호출 및 기타 API 작업이 발생하는지 확인합니다. 자세한 내용은 Lambda API를 사용하여 함수의 상태 모니터링AWS Lambda 함수의 상태 추적을 참조하세요.

InvalidRuntimeException

함수 코드에 올바른 Lambda 런타임을 사용하도록 Lambda 함수를 구성합니다.

InvalidSecurityGroupIDException

Lambda 함수 구성에서 올바른 Amazon VPC 보안 그룹 ID를 지정했는지 확인합니다. 자세한 내용은 VPC의 리소스에 액세스하도록 Lambda 함수 구성을 참조하세요.

InvalidZipFileException

Lambda 배포 패키지에 대한 권한을 확인합니다. 자세한 내용은 배포 패키지를 업로드할 때 Lambda "permission denied" 또는 "unable to import module" 오류를 해결하려면 어떻게 해야 합니까?를 참조하세요.

또한 배포 패키지 파일을 올바르게 생성했는지 확인합니다. 자세한 내용은 Lambda 배포 패키지를 참조하세요.

KMSAccessDeniedException

Lambda 함수의 AWS Identity and Access Management(IAM) 권한과 AWS Key Management Service(AWS KMS) 키 정책을 확인합니다.

KMSAccessDeniedException 오류는 일반적으로 Lambda 함수의 IAM 역할을 삭제한 후 동일한 이름으로 다시 생성할 때 발생합니다. 이런 경우, 해당 함수에 대하여 새 IAM 역할을 구성합니다. 그런 다음, 함수를 재배포하고 이전 IAM 역할을 다시 구성합니다.

자세한 내용은 AWS KMS에서 키 정책 사용을 참조하세요.

참고: 또한 Lambda 함수를 생성하고 업데이트하는 IAM 사용자KMS 키를 사용할 수 있는 권한이 있어야 합니다.

KMSDisabledException

KMS 키가 활성화되었는지 확인합니다. 자세한 내용은 키 활성화 및 비활성화를 참조하세요.

KMSInvalidStateException

AWS 키가 AWS KMS Decrypt API 요청에 대해 유효한 상태가 아닙니다. AWS 키가 활성화되었는지 확인합니다.

자세한 내용은 키 상태가 고객 관리형 키 사용에 미치는 영향을 참조하세요.

KMSNotFoundException

요청에 지정된 KMS 키는 Lambda 함수와 동일한 AWS 지역 및 계정에 있어야 합니다. 지역이 다른 경우 동일한 지역에서 다른 KMS 키를 사용하거나 새 KMS 키를 생성합니다.

ResourceNotReadyException

Lambda는 사용 중이지 않은 네트워크 인터페이스를 회수합니다. 이 작업은 비활성 상태의 함수를 배치할 수 있습니다. 비활성 상태의 함수를 호출하면 VPC 네트워크 액세스가 복원되는 동안 해당 함수는 대기 중 상태로 전환됩니다. 첫 번째 호출 및 함수가 대기 중 상태일 때 발생하는 다른 모든 호출은 실패하고 ResourceNotReadyException 오류가 발생합니다.

오류를 해결하려면 VPC 연결이 복원될 때까지 기다립니다. 그런 다음 Lambda 함수를 다시 호출합니다.

ServiceException

Lambda 서비스 자체에 내부 오류가 발생하는 경우도 있습니다. 500 오류가 발생하면 AWS 서비스 상태 대시보드에서 Lambda를 사용할 수 없는지 확인합니다. 자세한 내용은 AWS가 작동하지 않습니까?를 참조하세요.

Lambda를 사용할 수 있는 경우 요청을 다시 시도하여 Lambda 함수를 호출합니다.

SubnetIPAddressLimitReachedException

서브넷의 크기는 서브넷의 CIDR 블록에 의해 정의됩니다. Amazon VPC에서 지정하는 CIDR 블록에 Amazon VPC 지원 Lambda 함수의 요구 사항에 맞는 충분한 여유 IP 주소가 있는지 확인합니다. 자세한 내용은 VPC 및 서브넷 크기 조정을 참조하세요.

계정에 대한 하이퍼플레인 탄력적 네트워크 인터페이스의 최대 한도를 초과했습니다.

각 Virtual Private Cloud(VPC)에 대하여 하이퍼플레인 탄력적 네트워크 인터페이스의 기본 한도는 최대 250개입니다. 한도 증가 요청 방법에 대한 자세한 내용은 Service Quotas를 참조하세요.


이 문서가 도움이 되었나요?


결제 또는 기술 지원이 필요하세요?