Não foi possível iniciar o processo local do DynamoDB

TL;DR — DynamoDB Local (um aplicativo Java) não pôde ser iniciado. As causas comuns são um tempo de execução Java ausente ou muito antigo, porta 8000 já utilizada ou o plug-in serverless-dynamodb nunca baixou o jar. Corrija o Java, libere a porta ou reinstale.

O que significa

Você verá isso no plugin serverless-dynamodb / serverless-dynamodb-local ou ao executar o jar diretamente:

Unable to start DynamoDB Local process!

O processo filho que roda o emulador local não conseguiu ser criado ou saiu imediatamente.

Por que isso acontece

Sem Java, ou uma versão incompatível. O DynamoDB Local precisa de um runtime Java — as versões atuais (v2.6.0 e mais recentes, incluindo a v3.x) exigem JRE 17+. Se java -version falha, é isso; se ele imprime uma versão antiga, você costuma ver UnsupportedClassVersionError na saída subjacente.
Porta já em uso — algo mais está na 8000 (uma instância anterior que não foi encerrada).
O jar nunca foi instalado — o sls dynamodb install não rodou ou falhou, então não há nada para iniciar.
Um problema de caminho/permissões com o diretório de instalação.
Incompatibilidade de Apple Silicon / arquitetura com um jar antigo que embute bibliotecas SQLite nativas.

Falhas de download

Quando o npx serverless dynamodb install ou o download do plugin Maven falha (proxy de rede, inspeção TLS corporativa ou disco cheio), o comando de start não encontra nenhum jar e sai com o mesmo invólucro genérico Unable to start DynamoDB Local process! — verifique no log do plugin se há ENOENT ou erros HTTP antes de caçar problemas de Java.

Como corrigir

Instale/verifique o Java 17+: java -version. Se estiver faltando ou for antigo demais, instale um JDK/JRE atual (por exemplo, Temurin ou Corretto 17+).
Reinstale o DynamoDB Local:
```
npx serverless dynamodb install
```
Libere a porta (ou altere-a): encontre o que está em 8000 e pare —
```
lsof -i :8000   # then kill the PID, or configure a different port
```
Use a imagem oficial do Docker para contornar de vez os problemas de Java/arquitetura:
```
docker run -p 8000:8000 amazon/dynamodb-local
```
O Docker inclui um JRE compatível — não é necessária instalação local do Java.
Aponte seu cliente para ele com um marcador de região + endpoint (consulte Região ausente na configuração).

Conecte pelo DynoTable

Se o download do Java/arch ou de um jar com falha bloquear o Local, execute a imagem oficial do Docker e conecte o DynoTable sem um JRE local (Instalar DynoTable). Em Configurações → Perfis → Adicionar perfil, defina o endpoint http://localhost:8000, escolha uma região de espaço reservado e use credenciais alfanuméricas fictícias - então Teste Conexão. Esse caminho evita o Unable to start DynamoDB Local process! falha de geração inteiramente. Passo a passo: Executando DynamoDB local. Se o plugin nunca baixou o jar, execute novamente o npx serverless dynamodb install e confirme se o diretório de instalação é gravável - erros de permissão aparecem como o mesma mensagem genérica de spawn sem rastreamento de pilha Java. Depois que o Local estiver ativo, carregue os fixtures com o conversor DynamoDB JSON.

Erros relacionados

Não foi possível conectar ao DynamoDB Local
DynamoDB Local UnsupportedClassVersionError — o sabor Java muito antigo dessa falha.
Erros sqlite4java locais do DynamoDB — o sabor da biblioteca nativa/arch.
Região ausente na configuração Aprenda: Executando DynamoDB local

Referências

Implantando DynamoDB localmente em seu computador - AWS DynamoDB Developer Guide (requisito JRE 17+ para v2.6.0+, comando de inicialização, porta padrão 8000)
Notas de uso local do DynamoDB - AWS DynamoDB Developer Guide (-port e outras opções de tempo de execução)
amazon/dynamodb-local — Docker Hub (imagem oficial; docker run -p 8000:8000 amazon/dynamodb-local)

Última verificação em 13/07/2026 em relação à documentação oficial do AWS vinculada acima.