ConfigError: 구성에 지역이 없습니다.

TL;DR — AWS SDK는 어느 리전과 통신해야 할지 모릅니다. 클라이언트(new DynamoDBClient({ region: 'us-east-1' }))에서 명시적으로 설정하거나 AWS_REGION 환경 변수를 통해 또는 ~/.aws/config에서 설정합니다.

무엇을 의미하는가

ConfigError: Missing region in config

모든 DynamoDB 엔드포인트는 지역적이므로 SDK가 요청을 보내기 전에 지역을 확인해야 합니다. 이 정확한 표현은 기본적으로 지역을 선택하지 않는 JavaScript v2용 AWS SDK(현재 지원 종료)에서 나온 것입니다. 구성 소스 중 어느 것도 지역을 제공하지 않으면 네트워크 호출 전에 이를 발생시킵니다. 리전이 구성되지 않은 경우 다른 SDK 및 AWS CLI는 자체적으로 실패합니다.

왜 발생하는가

클라이언트에 전달된 리전이 없으며 환경에 AWS_REGION가 없습니다(JavaScript SDK는 AWS_REGION을 읽습니다. AWS CLI는 AWS_DEFAULT_REGION 및 --region도 인식합니다).
SDK가 읽지 않는 ~/.aws/config 지역 — JavaScript SDK v2는 AWS_SDK_LOAD_CONFIG 환경 변수가 설정된 경우에만 공유 구성 파일을 로드합니다. 이것이 없으면 완벽하게 좋은 region = 라인은 무시됩니다.
환경 변수 이름(AWS_REGIONS, REGION)에 오타가 있습니다.

해결 방법(다음 중 하나)

클라이언트에서 설정합니다(가장 명시적).

import {DynamoDBClient} from '@aws-sdk/client-dynamodb';
const client = new DynamoDBClient({region: 'us-east-1'});

환경 변수:
```
export AWS_REGION=us-east-1
```
AWS 구성 파일(~/.aws/config):
```
[default]
region = us-east-1
```
JavaScript SDK v2에서는 SDK가 실제로 이 파일을 읽도록 AWS_SDK_LOAD_CONFIG=1도 설정합니다(CLI 및 대부분의 다른 SDK는 기본적으로 이 파일을 읽습니다). 4. DynamoDB 로컬? 여전히 a 지역 문자열(모든 값 - 로컬 데이터베이스 파일 이름을 지정하는 데만 사용됨)과 endpoint이 필요합니다.
```
const client = new DynamoDBClient({region: 'local', endpoint: 'http://localhost:8000'});
```

DynoTable을 Local에 연결

DynoTable은 각 AWS profile에 지역을 저장합니다 — 설정 → 프로필 → 프로필 추가를 클릭한 다음 저장하기 전에 드롭다운에서 지역을 선택합니다. 사이드바 하단의 프로필 칩에는 활성 영역이 표시됩니다. 전환하려면 ⌘P를 누르세요. 영역이 비어 있거나 AWS_SDK_LOAD_CONFIG가 필요한 SDK에서 공유 구성 파일을 무시하면 연결 테스트가 빠르게 실패합니다.

로컬의 경우 로컬 다운로드를 사용하거나 프로필 끝점을 http://localhost:8000로 지정하고 지역 문자열을 설정합니다. DynoTable은 끝점과 지역이 드리프트할 수 없도록 동일한 프로필에 유지합니다. 연결되면 ⌘K가 포함된 테이블을 열고 요청이 예상하는 지역으로 이동하는지 확인하세요. 시각적 query builder은 동일한 설정을 애플리케이션 코드에 붙여넣기 전에 프로필 영역을 증명하는 데 유용합니다.

SDK v2와 v3 지역 해상도 차이를 디버깅할 때 DynoTable이 사용하는 프로필 설정을 애플리케이션의 환경 변수와 나란히 비교하세요. 스테이징(⌘S)을 사용하면 일괄 작업을 실행하기 전에 구성된 프로필에 대해 쓰기를 테스트할 수 있습니다.

출처

Setting the AWS Region — AWS SDK for JavaScript v2 (2026-07-13 검증)
Troubleshooting errors for the AWS CLI (2026-07-13 검증)

참고 자료

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