AZD Validation Errors
Pre-Deployment Errors
These errors can be caught before running azd up:
| Error | Cause | Resolution |
|---|---|---|
Please run 'az login' | Not authenticated | az login or azd auth login |
No environment selected | Missing azd environment | azd env select <name> or azd env new <name> --no-prompt |
no default response for prompt 'Enter a unique environment name' | No azd environment created, or missing -e flag | Run azd env new <name> --no-prompt OR use azd init --from-code -e <name> --no-prompt with the -e flag |
no default response for prompt 'Enter a value for the 'environmentName' | Environment variables not set | Run azd env set AZURE_ENV_NAME <name> |
Service not found | Service name mismatch | Check service name in azure.yaml |
Invalid azure.yaml | YAML syntax error | Fix YAML syntax |
Project path does not exist | Wrong service project path | Fix service project path in azure.yaml |
Cannot connect to Docker daemon | Docker not running | Start Docker Desktop |
npm ci fails with missing: package-lock.json | Dockerfile uses npm ci but package-lock.json not in build context | Run npm install --package-lock-only in the service directory before building |
Could not find a part of the path 'infra\main.bicep' | Missing infrastructure files | Generate infra/ folder before azd up |
Invalid resource group location '<loc>'. The Resource group already exists in location '<other>' | RG exists in different region | Check RG location first with az group show, use that region or new env name |
expecting only '1' resource tagged with 'azd-service-name: web', but found '2' | Multiple resources with same tag in the same RG | Delete duplicate or rename service |
Static Web App Errors
| Error | Cause | Fix |
|---|---|---|
language 'html' is not supported | Invalid language value | Omit language for pure static sites |
language 'static' is not supported | Invalid language value | Omit language for pure static sites |
dist folder not found | Wrong dist path or missing build | Check dist is relative to project; add language: js if build needed |
LocationNotAvailableForResourceType | SWA not in region | See Region Availability for valid regions |
SWA Path Validation
Before deployment, verify:
projectpath exists and contains source files- For framework apps:
language: jsis set distis relative toproject(not project root)- Bicep has
azd-service-nametag matching service name
Debug
azd <command> --debug