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

해결 방법

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

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

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 사용자는 AWS KMS 키를 사용할 수 있는 권한이 있어야 합니다.

KMSDisabledException

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

KMSInvalidStateException

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

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

KMSNotFoundException

요청에 지정된 AWS KMS 키는 Lambda 함수와 동일한 AWS 리전 및 계정에 있어야 합니다. 리전이 다른 경우 동일한 리전에서 다른 AWS KMS 키를 사용합니다(또는 새 AWS 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를 참조하세요.

---