DynamoDB 로컬 프로세스를 시작할 수 없습니다

TL;DR — DynamoDB Local(Java 앱)을 시작할 수 없습니다. 일반적인 원인은 Java 런타임이 없거나 너무 오래되었거나, 포트 0이 이미 사용되었거나, serverless-dynamodb 플러그인이 jar을 다운로드하지 않았기 때문입니다. Java를 수정하고, 포트를 해제하거나 다시 설치하세요.

무엇을 의미하는가

serverless-dynamodb / serverless-dynamodb-local 플러그인에서 보거나 jar를 직접 실행할 때 볼 수 있습니다.

Unable to start DynamoDB Local process!

로컬 에뮬레이터를 실행하는 하위 프로세스가 생성되지 않았거나 즉시 종료되었습니다.

왜 발생하는가

Java가 없거나 호환되지 않는 버전입니다. DynamoDB Local에는 Java 런타임이 필요합니다. 현재 버전(v2.6.0 이상, v3.x 포함)에는 JRE 17+이 필요합니다. java -version이 실패하면 그게 전부입니다. 이전 버전을 인쇄하는 경우 기본 출력에 UnsupportedClassVersionError가 표시되는 경우가 많습니다.
포트가 이미 사용 중 — 8000(종료되지 않은 이전 인스턴스)에 다른 항목이 있습니다.
병이 설치되지 않았습니다 — sls dynamodb install가 실행되지 않았거나 실패했기 때문에 시작할 것이 없습니다.
설치 디렉터리에 경로/권한 문제가 있습니다.
기본 SQLite 라이브러리를 번들로 제공하는 오래된 jar와 Apple Silicon/아치 불일치.

다운로드 실패

npx serverless dynamodb install 또는 Maven 플러그인 다운로드가 실패한 경우 (네트워크 프록시, 기업 TLS 검사 또는 전체 디스크), start 명령은 다음을 찾습니다. 병이 없고 동일한 일반 Unable to start DynamoDB Local process!로 종료됩니다. 래퍼 — Java를 추적하기 전에 플러그인 로그에서 ENOENT 또는 HTTP 오류를 확인하세요.

어떻게 해결하는가

Java 17+ 설치/확인: java -version. 누락되었거나 너무 오래된 경우 최신 JDK/JRE(예: Temurin 또는 Corretto 17+)를 설치하세요.
DynamoDB 로컬 재설치:
```
npx serverless dynamodb install
```
포트를 해제(또는 변경): 8000에 있는 내용을 찾아 중지합니다.
```
lsof -i :8000   # then kill the PID, or configure a different port
```
공식 Docker 이미지를 사용하여 Java/arch 문제를 완전히 회피하세요.
```
docker run -p 8000:8000 amazon/dynamodb-local
```
Docker는 호환 가능한 JRE를 번들로 제공하므로 로컬 Java 설치가 필요하지 않습니다. 5. 자리 표시자 지역 + 끝점을 사용하여 클라이언트를 가리킵니다(Missing region in config 참조).

DynoTable에서 연결

Java/arch 또는 실패한 jar 다운로드로 인해 로컬이 차단되는 경우 공식 Docker 이미지를 실행하세요. 로컬 JRE(Install DynoTable) 없이 DynoTable을 연결합니다. 설정 → 프로필 → 프로필 추가에서 엔드포인트 http://localhost:8000를 설정하고, 자리 표시자 영역을 선택하고 영숫자 더미 자격 증명을 사용한 다음 테스트 연결. 그 경로는 Unable to start DynamoDB Local process!를 피합니다. 완전히 스폰 실패. 연습: Running DynamoDB Local. 플러그인이 jar를 다운로드하지 않은 경우 npx serverless dynamodb install를 다시 실행하세요. 설치 디렉터리가 쓰기 가능한지 확인합니다. 권한 오류는 Java 스택 추적이 없는 동일한 일반 생성 메시지입니다. Local이 실행된 후 Fixture를 로드합니다. DynamoDB JSON converter로.

참고 자료

Deploying DynamoDB locally on your computer — AWS DynamoDB Developer Guide(v2.6.0+에 대한 JRE 17+ 요구 사항, 실행 명령, 기본 포트 8000)
DynamoDB local usage notes — AWS DynamoDB Developer Guide (-port 및 기타 런타임 옵션)
amazon/dynamodb-local — Docker Hub (공식 이미지; docker run -p 8000:8000 amazon/dynamodb-local)

위에 링크된 공식 AWS 문서를 기준으로 2026년 7월 13일에 마지막으로 확인되었습니다.