Error: DynamoDB Not Supported Requires @DynamoDBTyped Or @DynamoDBTypeConverted

Answered by Rafal Wilinski
Last updated: October 23rd, 2026
Solution
not supported; requires @DynamoDBTyped or @DynamoDBTypeConverted comes from Java SDK 1.x DynamoDBMapper when it cannot map a property. This is a client mapping issue; DynamoDB itself supports document maps and lists.
- Identify the getter and declared Java type named in the exception, including collection element types.
- Use @DynamoDBTyped when the mapper supports the Java type but needs an explicit DynamoDB representation. It does not teach the mapper how to serialize any arbitrary class.
- For a custom scalar representation, implement DynamoDBTypeConverter and attach @DynamoDBTypeConverted to the accessor. Test convert and unconvert with existing records.
- For a nested document, consider @DynamoDBDocument on an appropriate bean. Ignore a property only when it should not be persisted.
Do not add annotations indiscriminately or convert every object to an opaque string. Choose a representation that supports the reads and expressions your application needs.
For current Java code, migrate to the v2 Enhanced Client. Its equivalents are a mapped bean or schema, AttributeConverter, and @DynamoDbConvertedBy. V1 and v2 annotations are different APIs and cannot be mixed to configure one mapper.
See Java mapping guidance and AWS documentation.
Enhanced Client converter configuration covers the current API.
Other Common DynamoDB Errors (with Solutions)
- name key is not defined dynamodb
- dynamodb list_append if_not_exists not working
- dynamodb update fail if not exists
- DynamoDB console unable to delete this item
- DynamoDB No Provisioned Throughput specified for the table
- dynamodb item size limit error
- missing required key 'key' in params dynamodb
- dynamodb request is missing authentication token
- requested resource not found aws dynamodb
- DynamoDB Contains not working
- dynamodb could not instantiate class
- dynamodb getItem() is not a function
- DynamoDB Local Docker Not Working
- Error ValidationException: One or more parameter values were invalid: Type mismatch for key X expected: S actual: M
- DynamoDB Network Error: self signed certificate in chain
Dynobase is a Professional GUI Client for DynamoDB
Start your 7-day free trial today