Errores comunes de DynamoDB (y cómo solucionarlos)
Los errores de DynamoDB con los que más tropiezan los desarrolladores — cada uno con qué significa, por qué ocurre y la solución exacta.
Errores de validación y expresiones (52)
DynamoDB ValidationException — Causas y cómo solucionarla
Una ValidationException de DynamoDB indica que la petición se rechazó por mal formada antes de ejecutarse. Los casos comunes, el mensaje y su solución.
"Query condition missed key schema element" — Solución en DynamoDB
Query condition missed key schema element significa que tu KeyConditionExpression no lleva igualdad en la clave de partición. Consulta un GSI o usa Scan.
"The provided key element does not match the schema" — Solución en DynamoDB
ValidationException: el nombre o tipo de un atributo de clave no coincide con el KeySchema — falta la clave de ordenación, o un número se envió como cadena.
"Error de sintaxis UpdateExpression" no válido: DynamoDB Solución
Un UpdateExpression no válido suele ser una palabra clave reservada que se utiliza sin formato o que falta un marcador de posición #name o :value. Alias de nombres reservados con ExpressionAttributeNames y valores de enlace con ExpressionAttributeValues.
"ExpressionAttributeValues contiene un valor no válido" — DynamoDB Arreglar
Este ValidationException significa que un valor en ExpressionAttributeValues está vacío, es del tipo incorrecto o es un marcador de posición que su expresión nunca definió.
"Item size has exceeded the maximum allowed size" — Solución en DynamoDB
Los Items de DynamoDB están limitados a 400 KB. Esta ValidationException significa que tu Item supera el límite — cómo comprobar el tamaño y bajar de él.
DynamoDB ConditionalCheckFailedException — Causas y solución
ConditionalCheckFailedException significa que tu ConditionExpression evaluó a false, así que DynamoDB rechazó la escritura y dejó el item sin cambios.
DynamoDB TransactionCanceledException — Descifra las razones de cancelación
TransactionCanceledException significa que un Item falló y toda la transacción se revirtió. Lee el array CancellationReasons para saber qué Item y por qué.
DynamoDB SerializationException — Causas y solución
SerializationException: tu JSON no casa con el formato de transferencia de DynamoDB — normalmente un número como cadena. Corrige los AttributeValue.
"Supplied AttributeValue is empty" — Solución DynamoDB
ValidationException: un AttributeValue no tiene valor tipado — un conjunto vacío, una clave en cadena vacía o un campo undefined. Quítalo o dale un valor.
"One or more parameter values were invalid" — Solución DynamoDB
ValidationException: un valor rompe una regla de DynamoDB — conjunto vacío, clave en cadena vacía o tipo que no encaja. El mensaje nombra el parámetro.
"Invalid size for parameter" — Solución DynamoDB de escritura vectorial
DynamoDB rechaza una escritura vectorial cuando el número de dimensiones del embedding no coincide con el índice vectorial. El mensaje nombra el atributo y ambos tamaños.
"Search vector contains invalid values" — Solución DynamoDB
SearchVectors rechaza un vector de consulta envuelto en el tipo L de DynamoDB o que lleva valores que no son float. El parámetro es un array JSON pelado, no un atributo List.
"SearchConditionExpression must be provided" — Solución DynamoDB
Un índice vectorial con una clave HASH en su search schema exige que cada llamada a SearchVectors fije exactamente un valor de partición. El filtro dejó de ser opcional al crear el índice.
"Query key condition not supported" — Solución DynamoDB
DynamoDB rechaza una KeyConditionExpression con un operador que el esquema de claves prohíbe — la clave de partición solo admite igualdad. Los permitidos.
"Attribute name is a reserved keyword" — Solución DynamoDB
DynamoDB rechaza palabras reservadas como status, name o size como nombres de atributo directos. Ponles un alias de ExpressionAttributeNames como #status.
"Float types are not supported" — Solución boto3 de DynamoDB
boto3 lanza TypeError "Float types are not supported" porque DynamoDB guarda decimales exactos. Convierte los floats a decimal.Decimal desde su cadena.
"Number overflow" — Solución del límite de tamaño de número de DynamoDB
El tipo N de DynamoDB admite 38 dígitos de precisión y una magnitud hasta ~9.9E+125. Más allá, guarda IDs grandes y valores de alta precisión como cadenas.
"The provided expression refers to an attribute that does not exist" — Solución
Tu UpdateExpression o ConditionExpression apunta a una ruta que no está en el Item — falta el mapa padre, una errata u operar sobre un atributo ausente.
"La lista proporcionada de claves de elementos contiene duplicados" (BatchGetItem) — Arreglar
DynamoDB rechaza un BatchGetItem cuando la lista de claves de una tabla repite una clave principal. Todo el lote falla, así que elimine las duplicaciones de las claves antes de enviarlas.
"Provided list of item keys contains duplicates" (BatchWriteItem) — Solución
DynamoDB rechaza un BatchWriteItem cuando dos acciones apuntan a la misma clave primaria. Un lote no puede tocar un Item dos veces, colapsa los duplicados.
"El tamaño de la expresión ha excedido el tamaño máximo permitido" (4 KB) — Corrección
DynamoDB limita cada cadena de expresión a 4 KB. Un pasado FilterExpression, ConditionExpression o UpdateExpression que se rechaza. Cómo reducirlo.
"El tamaño agregado de todas las claves de rango ha excedido el límite de tamaño" — Arreglar
DynamoDB limita una clave de clasificación a 1024 bytes y una clave de partición a 2048 bytes. Reduzca los valores de los atributos clave o haga un hash de identificadores largos antes de almacenarlos.
"La expresión de filtro sólo puede contener atributos de clave no principal" — Arreglar
DynamoDB rechaza un FilterExpression que nombra una partición o clave de clasificación. Las claves pertenecen al KeyConditionExpression; aquí se explica cómo reestructurar el query.
DynamoDB BatchGetItem, límite de 100 elementos — solución de "Too Many Items"
BatchGetItem acepta como máximo 100 elementos (y 16 MB) por llamada. Solicite más y DynamoDB rechaza toda la solicitud. El límite, más el bucle de fragmentación.
"Se solicitaron demasiados elementos para la llamada BatchWriteItem" — Solución
BatchWriteItem acepta como máximo 25 acciones de colocación o eliminación por llamada. Envíe más y DynamoDB rechaza toda la solicitud con un ValidationException.
DynamoDB "Can Not Use Both Expression and Non-Expression Parameters" — Solución
DynamoDB rechaza una solicitud que combina un parámetro heredado como KeyConditions con KeyConditionExpression. Elimine el parámetro heredado y utilice expresiones.
"Local secondary indexes must be specified at table creation" — Corrección
Un índice secundario local solo se puede definir cuando se crea la tabla y nunca se agrega más tarde. Por qué existe la restricción y cómo solucionarla.
DynamoDB TransactionCanceledException — Solución de ConditionalCheckFailed
Un TransactWriteItems cancelado con ConditionalCheckFailed significa que la condición de un item falló y revirtió toda la transacción. Cómo encontrarlo.
"Valor proporcionado en ExpressionAttributeNames no utilizado en expresiones" — Corrección
DynamoDB rechaza una solicitud que declara un ExpressionAttributeNames alias sin referencias de expresión. Elimínelo o corrija la expresión que lo omitió.
"Valor proporcionado en ExpressionAttributeValues no utilizado en expresiones" — Corrección
DynamoDB rechaza una solicitud que declara un marcador de posición ExpressionAttributeValues que no utiliza ninguna expresión. Elimine el valor huérfano o corrija la expresión.
DynamoDB S3 Error de importación: corrección de formato no válido
DynamoDB La importación desde S3 falla cuando los objetos no coinciden con el formato de entrada o la compresión declarados, o cuando los elementos carecen de la clave principal.
"Size of hashkey has exceeded the maximum size limit of 2048 bytes" — Solución
Una clave de partición DynamoDB puede tener como máximo 2048 bytes y una clave de clasificación 1024 bytes. Si se excede cualquiera de los dos, se rechaza la escritura; aquí se explica cómo rediseñar la clave.
DynamoDB GSI "Does Not Project" atributo — Solución
Un GSI devuelve solo los atributos de clave más su proyección, así que pedirle otra cosa falla. Cambia la proyección o la petición — aquí tienes cómo.
"Los niveles de anidamiento han excedido los límites admitidos" — DynamoDB Corrección de 32 niveles
DynamoDB mayúsculas asignan y enumeran el anidamiento en 32 niveles; los documentos más profundos arrojan "Los niveles de anidamiento han excedido los límites admitidos". Aplana mapas y listas anidados por debajo de 32 niveles.
"Segment must be less than TotalSegments" — Corrección del Scan paralelo
El Scan paralelo requiere 0 ≤ Segment < TotalSegments, y ambos deben enviarse juntos. Asigne a cada trabajador un segmento distinto de 0 a TotalSegments − 1.
DynamoDB "Cannot Specify AttributesToGet When Select Is COUNT" — Solución
DynamoDB rechaza un Query o Scan que establece Select=COUNT con un ProjectionExpression o AttributesToGet. COUNT devuelve un número, así que descarta la proyección.
DynamoDB Streams "El ARN proporcionado no es válido" — Solución
DynamoDB Streams rechaza una transmisión con formato incorrecto o de marcador de posición ARN como /stream/latest. Pase el LatestStreamArn real que DescribeTable devuelve, palabra por palabra.
"La solicitud de transacción no puede incluir múltiples operaciones en un artículo" — Corrección
DynamoDB rechaza una llamada TransactWriteItems cuando dos acciones tienen como objetivo la misma clave principal. Contraiga los duplicados o mueva uno a una escritura separada.
DynamoDB TransactWriteItems Límite de 100 acciones: arreglar
TransactWriteItems límites a 100 acciones; más allá de eso, obtienes un ValidationException en la longitud de TransactItems. Divídelo o usa BatchWriteItem a 25 por llamada.
El atributo TTL de DynamoDB debe ser un Number — Causas y solución
El TTL de DynamoDB solo caduca Items cuyo atributo TTL es un Number en segundos de época Unix. Una cadena, milisegundos o un atributo ausente no caducan.
DynamoDB "La expresión no puede estar vacía" — Corrección
DynamoDB rechaza un parámetro de expresión pasado como una cadena vacía. Omite FilterExpression o UpdateExpression por completo cuando no tengas nada que enviar.
"ExpressionAttributeNames contiene una clave no válida: error de sintaxis" — Solución
DynamoDB rechaza un mapa ExpressionAttributeNames cuya clave de marcador de posición rompe la sintaxis `#name`. La regla de nomenclatura y dónde pertenece el nombre real.
"Two document paths overlap with each other" (DynamoDB) — Solución
DynamoDB rechaza un UpdateExpression que asigna a la vez una ruta padre y otra anidada dentro. Mete el hijo en el padre o divide en dos actualizaciones.
"The document path provided in the update expression is invalid" — Solución
Una ruta de documento inválida significa que el padre de tu atributo anidado no existe o no es un map. DynamoDB nunca lo crea solo, así que créalo tú primero.
"Un operando en la expresión de actualización tiene un tipo de datos incorrecto" — Arreglar
El tipo del operando de actualización no coincide con lo que está almacenado: ADD en un conjunto que no es un número, list_append en un conjunto que no es una lista y no coincide.
DynamoDB IdempotentParameterMismatchException — Causas y solución
TransactWriteItems rechaza un reintento que reutiliza un ClientRequestToken con otro payload en la ventana de idempotencia de 10 minutos. La solución.
"Las lecturas consistentes no son compatibles con los índices secundarios globales" — Corrección
Query hacer un GSI con ConsistentRead verdadero arroja un ValidationException. GSIs sirven eventualmente solo lecturas consistentes. Suelta la bandera o lee la tabla base.
DynamoDB DuplicateItemException (PartiQL INSERT) — Causas y solución
PartiQL INSERT falla con DuplicateItemException cuando la clave primaria ya existe. A diferencia de PutItem, nunca sobrescribe: usa UPDATE o PutItem.
"Inesperado de la fuente" (DynamoDB PartiQL) — Arreglar
PartiQL arroja "Inesperado del origen" cuando el nombre de una tabla con guiones u otros caracteres especiales no está entre comillas dobles en FROM. Un par de comillas lo soluciona.
boto3 "Parameter validation failed" (ParamValidationError) — Solución
botocore lanza ParamValidationError antes de que la petición llegue a DynamoDB — suele ser una confusión de tipos entre client y resource. Cómo corregirlo.
"La clave de inicio proporcionada no es válida" (DynamoDB) — Arreglar
DynamoDB rechaza una ExclusiveStartKey que no coincide con la clave schema de la tabla o índice que está paginando. Pase LastEvaluatedKey palabra por palabra.
Errores de rendimiento y limitación (11)
DynamoDB ProvisionedThroughputExceededException — Causas y solución
DynamoDB lanza ProvisionedThroughputExceededException cuando lecturas o escrituras superan la capacidad aprovisionada de una tabla o un GSI. Qué se agotó.
DynamoDB ThrottlingException — Causas y solución
ThrottlingException significa que su tasa de solicitudes superó un límite, a menudo en llamadas del plano de control como CreateTable. Vuelva a intentarlo con retroceso exponencial y reduzca la velocidad.
DynamoDB ItemCollectionSizeLimitExceededException: causas y solución
Este error solo afecta a las tablas con un índice secundario local: una colección de elementos (todos los elementos que comparten una clave de partición) superó los 10 GB.
DynamoDB RequestLimitExceeded — Causas y solución
RequestLimitExceeded es un límite de cuenta — bajo demanda, 40 000 unidades de petición de lectura y escritura por segundo. Súbelo en Service Quotas.
DynamoDB TransactionConflictException: causas y solución
TransactionConflictException significa que otra transacción ya está tocando el mismo elemento. Es transitorio: vuelva a intentarlo con una pausa y mantenga las transacciones pequeñas.
"Provisioned throughput decreases are limited within a given day" — Solución
DynamoDB limita cuántas veces puedes bajar la capacidad aprovisionada por día UTC. Las cuentas de la cuota y cómo sortear el error de UpdateTable.
DynamoDB On-Demand Throughput Exceeded — Causas y solución
Las tablas bajo demanda también se limitan — rendimiento máximo configurado, rampa sobre el doble de tu pico o cuota de tabla. Cómo subir los topes.
DynamoDB Throttled a pesar de la capacidad: corrección de partición activa
DynamoDB limita una clave de partición activa incluso con capacidad de tabla libre, porque cada partición física tiene un límite de 3000 RCU y 1000 WCU.
DynamoDB TransactionInProgressException: causas y solución
Un TransactWriteItems reintento reutilizó el ClientRequestToken de un intento que aún se estaba ejecutando. Continúe reintentando con retroceso y ajuste los tiempos de espera después de 5 segundos.
DynamoDB InternalServerError (HTTP 500): qué hacer
Un HTTP 500 de DynamoDB es una falla transitoria del lado del servicio, es seguro volver a intentarlo, pero es posible que aún se haya aplicado una escritura fallida. Reintentar con retroceso; Confirme la escritura antes de asumir el error.
DynamoDB ReplicatedWriteConflictException: causas y solución
En una tabla global fuertemente consistente de varias regiones, se rechaza una escritura cuando otra región modifica el mismo elemento. Se puede volver a intentar: así es como se hace.
Errores de tablas y recursos (19)
DynamoDB ResourceNotFoundException — Causas y solución
ResourceNotFoundException significa que la tabla o el índice no existe en la región y cuenta a la que estás llamando. Verifique el nombre, la región y las credenciales.
DynamoDB ResourceInUseException ("La tabla ya existe") - Solución
ResourceInUseException significa que la tabla ya existe o aún se está CREANDO, ACTUALIZANDO o ELIMINANDO. Verifique su estado con DescribeTable antes de actuar.
DynamoDB LimitExceededException: causas y solución
LimitExceededException significa demasiadas llamadas simultáneas a CreateTable, UpdateTable o DeleteTable, o un límite de cuenta alcanzado. Serialice las llamadas al plano de control y manténgase dentro de las cuotas de la cuenta.
"La tabla no tiene el índice especificado" — Arreglar
DynamoDB rechaza la llamada porque IndexName no existe en esa tabla, está mal escrito o GSI aún no está ACTIVO. Confirme IndexName en la tabla y que GSI esté ACTIVO.
DynamoDB BackupNotFoundException: causas y solución
DynamoDB BackupNotFoundException significa que ninguna copia de seguridad coincide con la BackupArn que pasó. Por lo general, un ARN incorrecto, una copia de seguridad eliminada o caducada, o una región incorrecta.
DynamoDB ReplicaNotFoundException: causas y solución
ReplicaNotFoundException significa que la réplica de la región que está actualizando no está en la tabla global: una región incorrecta, una réplica eliminada o una carrera.
"Intentando modificar un GSI que se está creando" — Arreglar
DynamoDB bloquea los cambios estructurales mientras aún se está construyendo un índice secundario global. Espere a que IndexStatus llegue a ACTIVO o ordene sus cambios.
DynamoDB ExportTableToPointInTime — solucionar PITR no activado
ExportTableToPointInTime exige PITR en la tabla de origen; si no, lanza PointInTimeRecoveryUnavailableException. La solución, en un solo comando.
DynamoDB No coincide la versión de la tabla global: causas y solución
La creación de tablas globales falla cuando las réplicas no se alinean: tablas que no están vacías, claves no coincidentes schemas o GSIs, o una combinación de las versiones API de 2017 y 2019.
DynamoDB LSI Colección de elementos Límite de 10 GB: causas y solución
Las tablas con un índice secundario local limitan cada colección de elementos a 10 GB; si se cruzan, las escrituras fallarán. Supervise ItemCollectionMetrics y vuelva a fragmentar.
DynamoDB No se puede acceder a la transmisión: solución de transmisión no habilitada
Un consumidor leyó un stream de DynamoDB en una tabla con Streams desactivado, o usó un ARN obsoleto. Habilite Streams y apúntelo al `LatestStreamArn` actual.
DynamoDB TableAlreadyExistsException / "La tabla ya existe" - Solución
Las restauraciones arrojan TableAlreadyExistsException; CreateTable e ImportTable informan ResourceInUseException. Se toma el nombre del objetivo, así que elija uno nuevo.
DynamoDB Streams ExpiredIteratorException — Causas y solución
Un iterador de shard de DynamoDB Streams vale 15 minutos. Úsalo después y GetRecords lanza ExpiredIteratorException. Cómo reanudar sin perder registros.
DynamoDB Streams TrimmedDataAccessException: causas y solución
Transmita records en vivo las 24 horas, por lo que un punto de control anterior arroja TrimmedDataAccessException. Reanudar desde TRIM_HORIZON y conciliar desde la tabla.
DynamoDB BackupInUseException: causas y solución
DynamoDB BackupInUseException significa que todavía se está ejecutando otra operación de copia de seguridad en la misma tabla. Espere a que termine y luego vuelva a intentar realizar la llamada.
DynamoDB InvalidRestoreTimeException: causas y solución
InvalidRestoreTimeException significa que su RestoreDateTime queda fuera de la ventana PITR de la tabla de hasta 35 días. Elija un RestoreDateTime dentro de la ventana PITR de la tabla (hasta 35 días).
DynamoDB PointInTimeRecoveryUnavailableException - Arreglar
Intentó una restauración a un momento dado en una tabla que nunca tenía PITR habilitado. Habilite las copias de seguridad continuas ahora y utilice una copia de seguridad bajo demanda para los datos actuales.
DynamoDB GlobalTableNotFoundException: causas y solución
GlobalTableNotFoundException significa que las tablas globales heredadas APIs no pueden ver su tabla (generalmente una tabla global del 2019.11.21 administrada a través de UpdateTable).
DynamoDB ReplicaAlreadyExistsException: causas y solución
Le pidió a DynamoDB que agregara una región de réplica que ya está en la tabla global. Describe primero el grupo de replicación y haga que la administración de réplicas sea idempotente.
Errores de autenticación y configuración (13)
"not authorized to perform dynamodb:..." — Solución de AccessDeniedException
DynamoDB AccessDeniedException significa que tu identidad de IAM no tiene permiso para la acción del mensaje. Cómo leerlo y corregir la política de IAM.
"ConfigError: Falta región en la configuración" — DynamoDB Solución
El AWS SDK no pudo determinar a qué región enviar DynamoDB solicitudes. Configúrelo en el client, a través de AWS_REGION, o en su configuración AWS; aquí está cada opción.
"La seguridad token incluida en la solicitud no es válida" — DynamoDB Solución
Esta UnrecognizedClientException significa que sus credenciales AWS son incorrectas, han caducado o no se han recogido. Verifique las claves de acceso, la caducidad de la sesión token y qué perfil cargó el SDK.
DynamoDB IncompleteSignatureException: causas y solución
IncompleteSignatureException significa que la firma SigV4 tenía un formato incorrecto (generalmente una firma manual o un proxy que reescribió el encabezado de Autorización).
"La seguridad token incluida en la solicitud ha caducado" — DynamoDB Solución
ExpiredTokenException significa que sus credenciales STS temporales, SSO o credenciales de rol asumido expiraron. Vuelva a ejecutar aws sso inicie sesión y borre cualquier AWS_SESSION_TOKEN.
"No se pueden localizar las credenciales" (boto3 / DynamoDB) — Arreglar
boto3 genera NoCredentialsError cuando nada en su cadena de proveedores proporciona AWS credenciales: sin variables de entorno, sin perfil, sin rol de instancia.
"La firma de la solicitud que calculamos no coincide" — Arreglar
DynamoDB devuelve InvalidSignatureException, no SignatureDoesNotMatch, cuando falla la firma SigV4. Por lo general, una clave secreta incorrecta o un reloj desviado en su máquina.
"La credencial debe tener como ámbito una región válida" — DynamoDB Arreglar
Este error SigV4 significa que la región en el alcance de su credencial no coincide con la región a la que realmente llamó. Cómo alinear client y endpoint regiones.
"InvalidSignatureException: Firma caducada" — DynamoDB Solución
DynamoDB rechaza una solicitud cuya marca de tiempo firmada está a más de cinco minutos de la hora del servidor AWS. Casi siempre client reloj desviado: aquí se explica cómo solucionarlo.
"Missing Authentication Token" — DynamoDB Solución de error
Una MissingAuthenticationTokenException de DynamoDB significa una URL de endpoint o una ruta incorrecta, o una solicitud que nunca llegó a firmarse. Verifique la URL del endpoint, la ruta y que la solicitud esté firmada con SigV4.
"No se pudieron cargar las credenciales de ningún proveedor" (DynamoDB) — Solución
El AWS SDK para JavaScript v3 genera CredentialsProviderError cuando toda su cadena de credenciales aparece vacía. Cómo se resuelve la cadena y cada solución.
"The SSO session associated with this profile has expired" — Solución
Un IAM Centro de identidad token interrumpe AWS CLI y SDK llamadas a DynamoDB. Ejecute aws sso inicio de sesión y borre un ~/.aws/sso/cache obsoleto si eso no es suficiente.
"The config profile could not be found" (AWS CLI y boto3) — Solución
AWS CLI y boto3 generan ProfileNotFound cuando el perfil nombrado falta en ~/.aws/config. Las tres causas habituales y la solución para cada una.
Errores de DynamoDB Local y configuración inicial (8)
"No se puede iniciar DynamoDB Proceso local" — Arreglar
DynamoDB Local no pudo iniciarse; generalmente falta un tiempo de ejecución de Java o es incompatible, un puerto ya en uso o una ruta de instalación incorrecta. Verifique el tiempo de ejecución de Java, los conflictos de puertos y la ruta de instalación.
"Could not connect to DynamoDB Local" (ECONNREFUSED) — Solución
ECONNREFUSED contra DynamoDB Local significa que no hay nada escuchando. Por lo general, el emulador no se está ejecutando, el puerto es incorrecto o el SDK está alcanzando el AWS real.
"Could not connect to the endpoint URL" (DynamoDB) — Solución
botocore genera EndpointConnectionError cuando no puede alcanzar DynamoDB. Por lo general, un endpoint URL, DynamoDB local que no se está ejecutando o una región defectuosa.
DynamoDB "Dirección local ya en uso" (puerto 8000) — Solución
DynamoDB Local arroja java.net.BindException cuando algo ya posee el puerto 8000. Cómo encontrar el proceso, liberar el puerto o iniciar Local en otro puerto.
DynamoDB Local "Failed to load native library sqlite4java" — Solución
DynamoDB Local muere al inicio con un UnsatisfiedLinkError para sqlite4java, causado por una java.library.path incorrecta o una discrepancia en el arco de Apple Silicon.
"No se puede ejecutar HTTP solicitud" (DynamoDB, Java SDK) — Solución
El AWS SDK para Java falla con No se puede ejecutar la solicitud HTTP cuando no puede alcanzar el endpoint. DynamoDB Local caído, puerto incorrecto o conexión en red Docker.
"No se pueden realizar operaciones en una tabla inexistente" (DynamoDB Local) — Arreglar
DynamoDB Local proporciona a cada par de credenciales y regiones su propia base de datos, por lo que una tabla que usted creó puede ser invisible. Ejecute Local con -sharedDb para compartir uno.
DynamoDB Error de versión de clase no compatible local: solución
DynamoDB Local 2.6.0 y versiones posteriores necesitan Java 17 o posterior. En un JRE antiguo, la JVM se niega a cargarlo. Instale un JDK actual o ejecute la imagen de Docker.
Cómo se verifican
La documentación parafrasea su propia implementación, y la paráfrasis se desvía. Cada mensaje de error citado en estas páginas se obtuvo ejecutando la llamada que falla contra el servicio real de AWS DynamoDB y anotando lo que devolvió, carácter a carácter — no copiándolo de la documentación de AWS.
No DynamoDB Local. El emulador es cómodo, pero AWS no promete que redacte los errores igual que el servicio — y, cuando lo comprobamos, más de la mitad de sus mensajes diferían. Donde la diferencia merece la pena, la página muestra los dos.
Las únicas ediciones están en las partes que describen tu solicitud y no el error: el nombre de la tabla y la copia de tu payload que el servicio reproduce. Un test hace fallar la compilación si alguna página cita una cadena que el servicio nunca devolvió — existe porque una de nuestras propias páginas citó un mensaje inventado durante meses antes de que nadie ejecutara el código.
58 mensajes repartidos en 14 tipos de excepción: 55 capturados contra el servicio real, 2 rechazados por el SDK antes de enviar la solicitud y 1 en los que el tema es la redacción propia de DynamoDB Local. 6 llevan una nota sobre cómo redacta el emulador ese mismo fallo.
- Servicio real
- Amazon DynamoDB (live service, us-east-1)
- Emulador (para comparar)
- DynamoDB Local (amazon/dynamodb-local)
- SDK de JavaScript
- @aws-sdk/client-dynamodb 3.1096.0
- SDK de Python
- boto3 1.43.81 on Python 3.14.7
- Node.js
- v24.20.0
Más recursos de DynamoDB
Aprende DynamoDB
Un temario estructurado de DynamoDB, desde los fundamentos hasta el funcionamiento interno.
Ejemplos de código de DynamoDB
Fragmentos listos para copiar y pegar para cada operación — SDK v3, boto3 y la AWS CLI.
FAQ de DynamoDB
Respuestas directas a las preguntas sobre DynamoDB que más hacen los desarrolladores.
Blog de ingeniería
Cómo está construido DynoTable: las historias detrás del agente de IA y el servidor MCP.
Herramientas de DynamoDB
Constructor de expresiones, calculadoras de precios y capacidad — directamente en tu navegador.
Trabaja con DynamoDB sin la Consola
Un cliente de escritorio rápido para DynamoDB que ejecuta el SQL real que DynamoDB no puede — JOINs, GROUP BY, agregaciones — con edición visual y un agente de IA con tus propias claves de Bedrock.
Prueba gratuita de 30 días, sin tarjeta — después, el plan Free sin límite de tiempo.