Unable to start DynamoDB Local process
TL;DR — DynamoDB Local (bir Java uygulaması) başlatılamadı. Olağan nedenler eksik veya çok eski bir Java çalışma zamanı, 8000 portunun zaten alınmış olması ya da serverless-dynamodb eklentisinin jar'ı hiç indirmemesidir. Java'yı düzeltin, portu serbest bırakın ya da yeniden kurun.
Ne anlama gelir
Bunu serverless-dynamodb / serverless-dynamodb-local eklentisinden ya da jar'ı doğrudan çalıştırdığınızda görürsünüz:
Unable to start DynamoDB Local process!Yerel emülatörü çalıştıran alt süreç oluşturulamadı ya da hemen çıktı.
Neden olur
- Java yok ya da uyumsuz bir sürüm. DynamoDB Local bir Java çalışma zamanına ihtiyaç duyar — güncel sürümler (v2.6.0 ve daha yenisi, v3.x dahil) JRE 17+ gerektirir.
java -versionbaşarısız olursa, sorun budur; eski bir sürüm yazdırırsa, altta yatan çıktıda genellikle UnsupportedClassVersionError görürsünüz. - Port zaten kullanımda —
8000'de başka bir şey var (kapanmayan önceki bir örnek). - Jar hiç kurulmadı —
sls dynamodb installçalışmadı ya da başarısız oldu, dolayısıyla başlatacak bir şey yok. - Kurulum diziniyle bir yol/izin sorunu.
- Yerel SQLite kitaplıklarını paketleyen eski bir jar ile Apple Silicon / mimari uyuşmazlığı.
İndirme hataları
npx serverless dynamodb install ya da Maven eklentisinin indirmesi başarısız
olduğunda (ağ proxy'si, kurumsal TLS denetimi ya da dolu disk), başlatma komutu
hiçbir jar bulamaz ve aynı genel Unable to start DynamoDB Local process!
sarmalayıcısıyla çıkar — Java'nın peşine düşmeden önce eklenti günlüğünde ENOENT
ya da HTTP hatalarına bakın.
Nasıl düzeltilir
- Java 17+'yi kurun/doğrulayın:
java -version. Eksikse ya da çok eskiyse, güncel bir JDK/JRE kurun (örneğin Temurin veya Corretto 17+). - DynamoDB Local'i yeniden kurun:
npx serverless dynamodb install - Portu serbest bırakın (ya da değiştirin): 8000'de neyin olduğunu bulun ve onu durdurun —
lsof -i :8000 # then kill the PID, or configure a different port - Java/mimari sorunlarını tamamen atlamak için resmi Docker imajını kullanın:
docker run -p 8000:8000 amazon/dynamodb-local - Bir yer tutucu bölge + uç noktayla istemcinizi ona yöneltin (Missing region in config'e bakın).
DynoTable'dan bağlanın
Java/arch veya başarısız bir jar indirmesi Yerel'i engelliyorsa resmi Docker görüntüsünü çalıştırın
ve yerel JRE (Install DynoTable) olmadan DynoTable'yı bağlayın.
Ayarlar → Profiller → Profil Ekle'de bitiş noktasını http://localhost:8000 olarak ayarlayın,
bir yer tutucu bölge seçin ve alfasayısal sahte kimlik bilgilerini kullanın - ardından Test Edin
Bağlantı. Bu yol Unable to start DynamoDB Local process!’den kaçınır
tamamen ortaya çıkma başarısızlığı. İzlenecek yol: Running DynamoDB Local.
Eklenti jar'ı hiç indirmediyse npx serverless dynamodb install'yi yeniden çalıştırın.
ve kurulum dizininin yazılabilir olduğunu onaylayın; izin hataları,
Java yığın izlemesi olmayan aynı genel ortaya çıkma mesajı. Yerel açıldıktan sonra fikstürleri yükleyin
DynamoDB JSON converter ile.
İlgili hatalar
- Could not connect to DynamoDB Local
- DynamoDB Local UnsupportedClassVersionError — bu hatanın çok-eski-Java sürümü.
- DynamoDB Local sqlite4java errors — yerel kitaplık/mimari sürümü.
- Yapılandırmada bölge eksik
- Öğrenin: Running DynamoDB Local
Kaynaklar
- 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 (
-portand the other runtime options) - amazon/dynamodb-local — Docker Hub (official image;
docker run -p 8000:8000 amazon/dynamodb-local)
En son 2026-07-13 tarihinde yukarıda bağlantısı verilen resmi AWS belgelerine karşı doğrulandı.