Documentazione Commerce Guida di Commerce sul cloud

Messaggi di errore per gli strumenti ECE

Ultimo aggiornamento: 14 maggio 2026

Argomenti:
Cloud

Creato per:

Developer

Questo riferimento ai messaggi di errore fornisce informazioni per la risoluzione dei problemi che possono verificarsi durante i processi di creazione, distribuzione e post-distribuzione di Adobe Commerce su infrastrutture cloud.

Tutti i messaggi di errore critici e di avvertenza che si verificano durante la distribuzione vengono scritti sia nei file var/log/cloud.log che in quelli /var/log/cloud.error.log. Il file di registro degli errori del cloud contiene solo errori della distribuzione più recente. Un file vuoto indica una distribuzione riuscita senza errori.

Nel file cloud.error.log, ogni voce è formattata come stringa JSON per facilitarne l’analisi:

{"errorCode":1006,"stage":"build","step":"validate-config","suggestion":"No stores/website/locales found in config.php\n  To speed up the deploy process do the following:\n  1. Using SSH, log in to your Magento Cloud account\n  2. Run \"php ./vendor/bin/ece-tools config:dump\"\n  3. Using SCP, copy the app/etc/config.php file to your local repository\n  4. Add, commit, and push your changes to the app/etc/config.php file","title":"The configured state is not ideal","type":"warning"}

I messaggi di errore sono suddivisi in categorie in base a una delle fasi di distribuzione: compilazione, distribuzione e post-distribuzione. Ogni sezione fornisce un elenco degli errori associati con le seguenti informazioni per ogni errore:

Codice errore: identificatore assegnato da Adobe Commerce per il messaggio di errore
Fase: indica se l’errore si è verificato durante la fase di compilazione, distribuzione o post-distribuzione
Passaggio: indica il passaggio nello scenario di distribuzione che può restituire l’errore. Se la colonna Passaggio è vuota, si tratta di un errore generale che può essere restituito da più passaggi o durante le operazioni di pre-elaborazione. Per ulteriori informazioni sui passaggi di compilazione, distribuzione e post-distribuzione, vedere Distribuzione basata su scenari.
Suggerimento: fornisce indicazioni per risolvere i problemi e risolvere l’errore
Titolo (descrizione errore): descrizione che riepiloga la causa dell’errore
Tipo: indica se l’errore è un errore critico o un avviso

Critical Errors

Critical errors indicate a problem with the Commerce on cloud infrastructure project configuration that causes deployment failure, for example incorrect, unsupported, or missing configuration for required settings. Before you can deploy, you must update the configuration to resolve these errors.

Build stage

Error code

Build step

Error description (Title)

Suggested action

Cannot write to the ./app/etc/env.php file

Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions.

Configuration is not defined in the schema.yaml file

Configuration is not defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct and defined.

Failed to parse the .magento.env.yaml file

The ./.magento.env.yaml file format is invalid. Use a YAML parser to check the syntax and fix any errors.

Unable to read the .magento.env.yaml file

Unable to read the ./.magento.env.yaml file. Check file permissions.

Unable to read the .schema.yaml file

Unable to read the ./vendor/magento/ece-tools/config/magento.env.yaml file. Check file permissions and redeploy (magento-cloud environment:redeploy).

refresh-modules

Cannot write to the ./app/etc/config.php file

The deployment script cannot make required changes to the /app/etc/config.php file. Check your filesystem permissions.

validate-config

Cannot read the composer.json file

Unable to read the ./composer.json file. Check file permissions.

validate-config

The composer.json file is missing required autoload section

Required autoload section is missing from the composer.json file. Compare the autoload section to the composer.json file in the Cloud template, and add the missing configuration.

validate-config

The .magento.env.yaml file contains an option that is not declared in the schema, or an option configured with an invalid value or stage

The ./.magento.env.yaml file contains invalid configuration. Check the error log for detailed info.

refresh-modules

Command failed: /bin/magento module:enable --all

Try to run composer update locally. Then, commit and push the updated composer.lock file. Also, check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

apply-patches

Failed to apply patch

set-report-dir-nesting-level

Cannot write to the file /pub/errors/local.xml

copy-sample-data

Failed to copy sample data files

compile-di

Command failed: /bin/magento setup:di:compile

Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output.

dump-autoload

Command failed: composer dump-autoload

The composer dump-autoload command failed. Check the cloud.log for more information.

run-baler

The command to run Baler for JavaScript bundling failed

Check the SCD_USE_BALER environment variable to verify that the Baler module is configured and enabled for JS bundling. If you do not need the Baler module, set SCD_USE_BALER: false.

compress-static-content

Required utility was not found (timeout, bash)

deploy-static-content

Command /bin/magento setup:static-content:deploy failed

Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

compress-static-content

Static content compression failed

Check the cloud.log for more information.

backup-data: static-content

Failed to copy static content into the init directory

Check the cloud.log for more information.

backup-data: writable-dirs

Failed to copy some writable directories into the init directory

Failed to copy writable directories into the ./init folder. Check your filesystem permissions.

Unable to create a logger object

backup-data: static-content

Failed to clean the ./init/pub/static/ directory

Failed to clean ./init/pub/static folder. Check your filesystem permissions.

Cannot find the Composer package

If you installed the Adobe Commerce application version directly from the GitHub repository, verify that the DEPLOYED_MAGENTO_VERSION_FROM_GIT environment variable is configured.

validate-config

Remove Magento Braintree module configuration which is no longer supported in Adobe Commerce and Magento Open Source 2.4 and later versions.

Support for the Braintree module is no longer included with Magento 2.4.0 and later. Remove the CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL variable from the variables section of the .magento.app.yaml file. For Braintree payment support, use an official extension from the Commerce Marketplace instead.

Deploy stage

Error code

Deploy step

Error description (Title)

Suggested action

101

pre-deploy: cache

Incorrect cache configuration (missing port or host)

Cache configuration is missing required parameters server or port. Check the cloud.log for more information.

102

Cannot write to the ./app/etc/env.php file

Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions.

103

Configuration is not defined in the schema.yaml file

Configuration is not defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it is defined.

104

Failed to parse the .magento.env.yaml file

Configuration is not defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it is defined.

105

Unable to read the .magento.env.yaml file

Unable to read the ./.magento.env.yaml file. Check file permissions.

106

Unable to read the .schema.yaml file

107

pre-deploy: clean-redis-cache

Failed to clean the Redis cache

Failed to clean the Redis cache. Check that the Redis cache configuration is correct and that the Redis service is available. See Setup Redis service.

140

pre-deploy: clean-valkey-cache

Failed to clean the Valkey cache

Failed to clean the Valkey cache. Check that the Valkey cache configuration is correct and that the Valkey service is available. See Setup Valkey service.

108

pre-deploy: set-production-mode

Command /bin/magento maintenance:enable failed

Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

109

validate-config

Incorrect database configuration

Check that the DATABASE_CONFIGURATION environment variable is configured correctly.

110

validate-config

Incorrect session configuration

Check that the SESSION_CONFIGURATION environment variable is configured correctly. The configuration must contain at least the save parameter.

111

validate-config

Incorrect search configuration

Check that the SEARCH_CONFIGURATION environment variable is configured correctly. The configuration must contain at least the engine parameter.

112

validate-config

Incorrect resource configuration

Check that the RESOURCE_CONFIGURATION environment variable is configured correctly. The configuration must contain at least connection parameter.

113

validate-config:elasticsuite-integrity

ElasticSuite is installed, but the ElasticSearch service is not available

Check that the SEARCH_CONFIGURATION environment variable is configured correctly, and verify that the Elasticsearch service is available.

114

validate-config:elasticsuite-integrity

ElasticSuite is installed, but another search engine is used

ElasticSuite is installed, but another search engine is configured. Update the SEARCH_CONFIGURATION environment variable to enable Elasticsearch, and verify the Elasticsearch service configuration in the services.yaml file.

115

Database query execution failed

116

install-update: setup

Command /bin/magento setup:install failed

Check the cloud.log and install_upgrade.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

117

install-update: config-import

Command app:config:import failed

Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

118

Required utility was not found (timeout, bash)

119

install-update: deploy-static-content

Command /bin/magento setup:static-content:deploy failed

Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

120

compress-static-content

Static content compression failed

Check the cloud.log for more information.

121

deploy-static-content:generate

Cannot update the deployed version

Cannot update the ./pub/static/deployed_version.txt file. Check your filesystem permissions.

122

clean-static-content

Failed to clean static content files

123

install-update: split-db

Command /bin/magento setup:db-schema:split failed

Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

124

clean-view-preprocessed

Failed to clean the var/view_preprocessed folder

Unable to clean the ./var/view_preprocessed folder. Check your filesystem permissions.

125

install-update: reset-password

Failed to update the /var/credentials_email.txt file

Failed to update the /var/credentials_email.txt file. Check your filesystem permissions.

126

install-update: update

Command /bin/magento setup:upgrade failed

Check the cloud.log and install_upgrade.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

127

clean-cache

Command /bin/magento cache:flush failed

Check the cloud.log for more information. For more detailed command output, add the VERBOSE_COMMANDS: '-vvv' option to the .magento.env.yaml file.

128

disable-maintenance-mode

Command /bin/magento maintenance:disable failed

Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output.

129

install-update: reset-password

Unable to read reset password template

130

install-update: cache_type

Command failed: php ./bin/magento cache:enable

Command php ./bin/magento cache:enable runs only when Adobe Commerce was installed but ./app/etc/env.php file was absent or empty at the beginning of the deployment. Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output.

131

install-update

The crypt/key key value does not exist in the ./app/etc/env.php file or the CRYPT_KEY cloud environment variable

This error occurs if the ./app/etc/env.php file is not present when Adobe Commerce deployment begins, or if the crypt/key value is undefined. If you migrated the database from another environment, retrieve the crypt key value from that environment. Then, add the value to the CRYPT_KEY cloud environment variable in your current environment. See Adobe Commerce encryption key. If you accidentally removed the ./app/etc/env.php file, use the following command to restore it from the backup files created from a previous deployment: ./vendor/bin/ece-tools backup:restore CLI command."

132

Cannot connect to the Elasticsearch service

Check for valid Elasticsearch credentials and verify that the service is running

137

Cannot connect to the OpenSearch service

Check for valid OpenSearch credentials and verify that the service is running

133

validate-config

Remove Magento Braintree module configuration which is no longer supported in Adobe Commerce or Magento Open Source 2.4 and later versions.

Support for the Braintree module is no longer included with Adobe Commerce or Magento Open Source 2.4.0 and later. Remove the CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL variable from the variables section of the .magento.app.yaml file. For Braintree support, use an official Braintree Payments extension from the Commerce Marketplace instead.

134

validate-config

Adobe Commerce and Magento Open Source 2.4.0 require Elasticsearch service to be installed

Install Elasticsearch service

138

validate-config

Adobe Commerce and Magento Open Source 2.4.4 requires OpenSearch or Elasticsearch service to be installed

Install OpenSearch service

135

validate-config

The search engine must be set to Elasticsearch for Adobe Commerce and Magento Open Source >= 2.4.0

Check the SEARCH_CONFIGURATION variable for the engine option. If it is configured, remove the option, or set the value to “elasticsearch”.

136

validate-config

Split Database was removed starting from Adobe Commerce and Magento Open Source 2.5.0.

If you use a split database you have to revert to or migrate to a single database or use an alternative approach.

139

validate-config

Incorrect search engine

This Adobe Commerce or Magento Open Source version does not support OpenSearch. Use versions 2.3.7-p3, 2.4.3-p2, or later

Post-deploy stage

Error code

Post-deploy step

Error description (Title)

Suggested action

201

is-deploy-failed

Deploy stage failed

202

The ./app/etc/env.php file is not writable

Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions.

203

Configuration is not defined in the schema.yaml file

Configuration is not defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it is defined.

204

Failed to parse the .magento.env.yaml file

The ./.magento.env.yaml file format is invalid. Use a YAML parser to check the syntax and fix any errors.

205

Unable to read the .magento.env.yaml file

Check file permissions.

206

Unable to read the .schema.yaml file

207

warm-up

Failed to preload some warm-up pages

208

time-to-firs-byte

Failed to test time to first byte (TTFB)

227

clean-cache

Command /bin/magento cache:flush failed

Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output.

General

Error code

General step

Error description (Title)

Suggested action

243

Configuration is not defined in the schema.yaml file

Check that the config variable name is correct, and that it defined.

244

Failed to parse the .magento.env.yaml file

The ./.magento.env.yaml file format is invalid. Use a YAML parser to check the syntax and fix any errors.

245

Unable to read the .magento.env.yaml file

Unable to read the ./.magento.env.yaml file. Check file permissions.

246

Unable to read the .schema.yaml file

247

Unable to generate a module for eventing

Check the cloud.log for more information.

248

Unable to enable a module for eventing

Check the cloud.log for more information.

249

Failed to generate the AdobeCommerceWebhookPlugins module

Check the cloud.log for more information.

250

Failed to enable the AdobeCommerceWebhookPlugins module

Check the cloud.log for more information.

Warning Errors

Warning errors indicate a problem with the Commerce on cloud infrastructure project configuration such as incorrect, deprecated, unsupported, or missing configuration settings for optional features that can affect site operation. Although a warning does not cause deployment failure, you should review warning messages and update the configuration to resolve them.

Build stage

Error code

Build step

Error description (Title)

Suggested action

1001

validate-config

File app/etc/config.php does not exist

1002

validate-config

The ./build_options.ini file is no longer supported

1003

validate-config

The modules section is missing from the shared config file

1004

validate-config

The configuration is not compatible with this version of Magento

1005

validate-config

SCD options ignored

1006

validate-config

The configured state is not ideal

1007

run-baler

Baler JS bundling cannot be used

Deploy stage

Error code

Deploy step

Error description (Title)

Suggested action

2001

pre-deploy:cache

Cache is configured for a Redis service that is not available. Configuration is ignored.

2032

pre-deploy:cache

Cache is configured for a Valkey service that is not available. Configuration is ignored.

2002

validate-config

The configured state is not ideal

2003

validate-config

The directory nesting level value for error reporting has not been configured

2004

validate-config

Invalid configuration in the ./pub/errors/local.xml file.

2005

validate-config

Admin data is used to create an admin user during initial installation only. Any changes to Admin data are ignored during the upgrade process.

After the initial installation, you can remove admin data from the configuration.

2006

validate-config

Admin user was not created as admin email was not set

After installation, you can create an admin user manually: Use ssh to connect to your environment. Then, run the bin/magento admin:user:create command.

2007

validate-config

Update php version to recommended version

2008

validate-config

Solr support has been deprecated in Adobe Commerce and Magento Open Source 2.1.

2009

validate-config

Solr is no longer supported by Adobe Commerce and Magento Open Source 2.2 or later.

2010

validate-config

Elasticsearch service is installed at the infrastructure layer, but it is not used as a search engine.

Consider removing the Elasticsearch service from the infrastructure layer to optimize resource usage.

2011

validate-config

Elasticsearch service version on infrastructure layer is not compatible with the current version of the elasticsearch/elasticsearch module, used by your Adobe Commerce application.

2012

validate-config

The current configuration is not compatible with this version of Adobe Commerce

2013

validate-config

SCD options ignored because the deploy process did not run on the build phase

2014

validate-config

The configuration contains deprecated variables or values

2015

validate-config

Environment configuration is not valid

2016

validate-config

JSON type configuration cannot be decoded

2017

validate-config

The current configuration is not compatible with this version of Adobe Commerce

2018

validate-config

Some services have passed EOL

2019

validate-config

The MySQL search configuration option is deprecated

Use Elasticsearch instead.

2029

validate-config

Split Database was deprecated in the Adobe Commerce and Magento Open Source 2.4.2 and will be removed in 2.5.

If you use a split database you should start planning to revert to or migrate to a single database or use an alternative approach.

2020

install-update

Adobe Commerce installation completed, but the app/etc/env.php configuration file was missing or empty.

Required data is restored from environment configurations and from the .magento.env.yaml file.

2021

install-update:db-connection

For split databases used custom connections

2022

install-update:db-connection

You have changed to a database configuration that is not compatible with the slave connection.

2023

install-update:split-db

Enabling a split database is skipped.

2024

install-update:split-db

The SPLIT_DB variable is missing the configuration for split connection types.

2025

install-update:split-db

Slave connection not set.

2026

pre-deploy:restore-writable-dirs

Failed to restore some data generated during the build phase to the mounted directories

Check the cloud.log for more information.

2027

validate-config:mage-mode-variable

Mode value for MAGE_MODE environment variable not supported

Remove the MAGE_MODE environment variable, or change its value to “production”. Adobe Commerce on cloud infrastructure supports “production” mode only.

2028

remote-storage

Remote storage could not be enabled.

Verify remote storage credentials.

2030

validate-config

Elasticsearch and OpenSearch services are both installed at infrastructure layer. Adobe Commerce and Magento Open Source 2.4.4 and later use OpenSearch by default

Consider removing the Elasticsearch or OpenSearch service from the infrastructure layer to optimize resource usage.

Post-deploy stage

Error code

Post-deploy step

Error description (Title)

Suggested action

3001

validate-config

Debug logging is enabled in Adobe Commerce

To save disk space, do not enable debug logging for your production environments.

3002

warm-up

Cannot fetch store urls

3003

warm-up

Cannot fetch store url

3004

backup

Cannot create backup files

General

Error code

General step

Error description (Title)

Suggested action

4001

Cannot get system processor count:

recommendation-more-help

commerce-on-cloud-help-cloud-guide