La versión AWS SDK para Java 1.x finalizó su soporte el 31 de diciembre de 2025. Le recomendamos que migre a AWS SDK for Java 2.x para seguir recibiendo nuevas características, mejoras de disponibilidad y actualizaciones de seguridad.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Tratamiento de excepciones
Es importante comprender cómo y cuándo se AWS SDK para Java producen las excepciones para crear aplicaciones de alta calidad con el SDK. En las siguientes secciones se describen los diferentes casos de excepciones que produce el SDK y cómo tratarlas correctamente.
¿Por qué usar excepciones no controladas?
AWS SDK para Java Utiliza excepciones de tiempo de ejecución (o no marcadas) en lugar de excepciones marcadas por los siguientes motivos:
-
Para permitir a los desarrolladores un control minucioso de los errores que desean administrar sin obligarles a abordar casos excepcionales que no les preocupan (o que les obligan a detallar su código en exceso)
-
Para evitar problemas de escalabilidad inherentes a las excepciones controladas en aplicaciones grandes
En general, las excepciones controladas funcionan bien a pequeña escala, pero pueden ser problemáticas cuando las aplicaciones crecen y se vuelven más complejas.
Para obtener más información sobre el uso de excepciones controladas y no controladas, consulte:
AmazonServiceException (y subclases)
AmazonServiceExceptiones la excepción más común que encontrarás al usar el AWS SDK para Java. Esta excepción representa una respuesta de error de un servicio de Servicio de AWS. Por ejemplo, si intentas terminar una Amazon EC2 instancia que no existe, EC2 devolverá una respuesta de error y todos los detalles de esa respuesta de error se incluirán en la AmazonServiceException que aparezca. En algunos casos, se produce una subclase de AmazonServiceException para permitir a los desarrolladores un control minucioso del tratamiento de casos de error a través de bloques de captura.
Cuando encuentre unAmazonServiceException, sabrá que su solicitud se envió correctamente al Servicio de AWS pero que no se pudo procesar correctamente. Esto puede ser debido a errores en los parámetros de la solicitud o a problemas en el servicio.
AmazonServiceException proporciona información como:
-
Código de estado HTTP devuelto
-
AWS Se devolvió el código de error
-
Mensaje de error detallado del servicio
-
AWS ID de solicitud de la solicitud fallida
AmazonServiceExceptiontambién incluye información sobre si la solicitud fallida fue culpa de la persona que llamó (una solicitud con valores no válidos) o Servicio de AWS de su culpa (un error de servicio interno).
AmazonClientException
AmazonClientExceptionindica que se ha producido un problema en el código del cliente Java, ya sea al intentar enviar una solicitud a AWS o al intentar analizar una respuesta desde AWS. Por lo generalAmazonServiceException, un AmazonClientException es más grave que un e indica un problema importante que impide que el cliente realice llamadas de servicio a AWS los servicios. Por ejemplo, se AWS SDK para Java produce AmazonClientException si no hay ninguna conexión de red disponible cuando se intenta llamar a una operación en uno de los clientes.
