ConfigError: Missing region in config

TL;DR — Das AWS SDK weiß nicht, mit welcher Region es sprechen soll. Setz sie explizit am Client (new DynamoDBClient({ region: 'us-east-1' })), über die Umgebungsvariable AWS_REGION oder in ~/.aws/config.

Was es bedeutet

ConfigError: Missing region in config

Jeder DynamoDB-Endpoint ist regional, daher muss das SDK eine Region auflösen, bevor es eine Anfrage senden kann. Genau dieser Wortlaut stammt vom AWS SDK for JavaScript v2 (inzwischen End-of-Support), das standardmäßig keine Region auswählt — wenn keine seiner Konfigurationsquellen eine liefert, wirft es diesen Fehler vor jedem Netzwerkaufruf. Andere SDKs und die AWS CLI scheitern mit ihrem eigenen Äquivalent, wenn keine Region konfiguriert ist.

Warum es passiert

Keine Region an den Client übergeben und kein AWS_REGION in der Umgebung (das JavaScript-SDK liest AWS_REGION; die AWS CLI berücksichtigt außerdem AWS_DEFAULT_REGION und --region).
Eine Region in ~/.aws/config, die das SDK nie liest — das JavaScript-SDK v2 lädt die gemeinsame Konfigurationsdatei nur, wenn die Umgebungsvariable AWS_SDK_LOAD_CONFIG gesetzt ist; ohne sie wird eine völlig korrekte region =-Zeile ignoriert.
Ein Tippfehler im Namen der Umgebungsvariable (AWS_REGIONS, REGION).

So behebst du es (eine davon genügt)

Setze sie direkt auf dem Client (am explizitesten):

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

Umgebungsvariable:
```
export AWS_REGION=us-east-1
```
AWS-Konfigurationsdatei (~/.aws/config):
```
[default]
region = us-east-1
```
Setze beim JavaScript-SDK v2 zusätzlich AWS_SDK_LOAD_CONFIG=1, damit das SDK diese Datei auch wirklich liest (die CLI und die meisten anderen SDKs lesen sie standardmäßig).
DynamoDB Local? Es braucht trotzdem eine Region als String (beliebiger Wert — er benennt nur die lokale Datenbankdatei) plus einen endpoint:
```
const client = new DynamoDBClient({region: 'local', endpoint: 'http://localhost:8000'});
```

DynoTable auf Local zeigen lassen

DynoTable stores region on each AWS profile — Einstellungen → Profile → Profil hinzufügen, then pick the region from the dropdown bevor du save. The profile chip at the bottom of the sidebar shows the active region; press ⌘P to switch. Test Connection fails fast when the region is blank or the shared config file is ignored by an SDK that needs AWS_SDK_LOAD_CONFIG.

Für Local, use Download Local (or point the profile endpoint at http://localhost:8000) and set any region string — DynoTable keeps endpoint and region on the same profile so they cannot drift. Sobald verbunden, öffne eine Tabelle mit ⌘K and confirm the request goes to the region you expect. The visual Query Builder is useful to prove the profile region bevor du paste the same settings into application code.

Wenn du Unterschiede in der Regionsauflösung zwischen SDK v2 und v3 debuggst, vergleich die Profileinstellungen, die DynoTable nutzt, direkt neben den Umgebungsvariablen deiner Anwendung. Mit Staging (⌘S) testest du einen Write gegen das konfigurierte Profil, bevor dein Batch-Job läuft.

Quellen

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

Referenzen

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