Unable to start DynamoDB Local process

TL;DR — DynamoDB Local (eine Java-Anwendung) konnte nicht starten. Die üblichen Ursachen sind eine fehlende oder zu alte Java-Runtime, ein bereits belegter Port 8000 oder ein serverless-dynamodb-Plugin, das das JAR nie heruntergeladen hat. Repariere Java, gib den Port frei oder installiere neu.

Was es bedeutet

Du siehst es vom serverless-dynamodb / serverless-dynamodb-local-Plugin oder beim direkten Ausführen des Jars:

Unable to start DynamoDB Local process!

Der Kindprozess, der den lokalen Emulator ausführt, konnte nicht gespawnt werden oder hat sich sofort beendet.

Warum es passiert

Kein Java oder eine inkompatible Version. DynamoDB Local braucht eine Java-Runtime — aktuelle Versionen (v2.6.0 und neuer, einschließlich v3.x) verlangen JRE 17+. Wenn java -version fehlschlägt, ist das die Ursache; wenn es eine alte Version ausgibt, siehst du oft UnsupportedClassVersionError in der zugrunde liegenden Ausgabe.
Port bereits belegt — etwas anderes ist auf 8000 (eine vorherige Instanz, die nicht heruntergefahren wurde).
Das Jar wurde nie installiert — sls dynamodb install lief nicht oder schlug fehl, sodass es nichts zu starten gibt.
Ein Pfad-/Berechtigungsproblem mit dem Installationsverzeichnis.
Apple Silicon / Arch-Diskrepanz mit einem alten Jar, das native SQLite-Libs bündelt.

Download-Fehlschläge

Wenn npx serverless dynamodb install oder der Maven-Plugin-Download scheitert (Netzwerk-Proxy, Corporate-TLS-Inspection oder eine volle Platte), findet der Start-Befehl kein JAR und beendet sich mit derselben generischen Hülle Unable to start DynamoDB Local process! — prüfe das Plugin-Log auf ENOENT oder HTTP-Fehler, bevor du Java verdächtigst.

So behebst du es

Installiere/verifiziere Java 17+: java -version. Wenn fehlend oder zu alt, installiere ein aktuelles JDK/JRE (z. B. Temurin oder Corretto 17+).
Installiere DynamoDB Local neu:
```
npx serverless dynamodb install
```
Gib den Port frei (oder ändere ihn): finde, was auf 8000 ist, und stoppe es —
```
lsof -i :8000   # then kill the PID, or configure a different port
```
Nutze das offizielle Docker-Image, um Java-/Arch-Probleme ganz zu umgehen:
```
docker run -p 8000:8000 amazon/dynamodb-local
```
Docker bringt eine kompatible JRE mit — eine lokale Java-Installation ist nicht nötig.
Richte deinen Client darauf aus mit einer Platzhalter-Region + einem Endpoint (siehe Missing region in config).

Aus DynoTable verbinden

Wenn Java/Arch oder ein gescheiterter JAR-Download Local blockieren, starte das offizielle Docker-Image und verbinde DynoTable ohne lokale JRE (DynoTable installieren). Setze unter Einstellungen → Profile → Profil hinzufügen den Endpoint http://localhost:8000, wähle eine Platzhalter-Region und nutze alphanumerische Dummy-Credentials — dann Verbindung testen. Dieser Weg umgeht den Spawn-Fehler Unable to start DynamoDB Local process! vollständig. Anleitung: Running DynamoDB Local. Hat das Plugin das JAR nie heruntergeladen, führe npx serverless dynamodb install erneut aus und bestätige, dass das Install-Verzeichnis beschreibbar ist — Berechtigungsfehler erscheinen als dieselbe generische Spawn-Meldung ohne Java-Stacktrace. Sobald Local läuft, lade Fixtures mit dem DynamoDB JSON Converter.

Referenzen

Deploying DynamoDB locally on your computer — AWS DynamoDB Developer Guide (JRE 17+ requirement for v2.6.0+, launch command, default port 8000)
DynamoDB local usage notes — AWS DynamoDB Developer Guide (-port and the other runtime options)
amazon/dynamodb-local — Docker Hub (official image; docker run -p 8000:8000 amazon/dynamodb-local)

Zuletzt verifiziert am 2026-07-13 gegen die oben verlinkte offizielle AWS-Dokumentation.