ECE工具的錯誤訊息

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
雲端

建立對象：

開發人員

此錯誤訊息參考提供在Adobe Commerce雲端基礎結構建置、部署和部署後程式期間可能發生的錯誤疑難排解資訊。

部署期間發生的所有嚴重和警告錯誤訊息都會寫入var/log/cloud.log和/var/log/cloud.error.log檔案。雲端錯誤記錄檔僅包含來自最新部署的錯誤。空白檔案表示部署成功且沒有錯誤。

在cloud.error.log檔案中，每個專案都會格式化為JSON字串，以便於剖析：

{"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"}

錯誤訊息會依部署階段之一進行分類：建置、部署和部署後。每個區段都會提供相關錯誤的清單，以及每個錯誤的下列資訊：

錯誤碼：錯誤訊息的Adobe Commerce指派識別碼
階段：指出錯誤是否發生在建置、部署或部署後階段
步驟：指出部署情境中可能傳回錯誤的步驟。如果 Step 資料行空白，則錯誤為一般錯誤，可由多個步驟傳回，或在前置處理作業期間傳回。請參閱以案例為基礎的部署，以取得有關建置、部署和部署後步驟的詳細資訊。
建議：提供疑難排解及解決錯誤的指南
標題（錯誤說明）：摘要說明錯誤原因
型別：指出錯誤是嚴重錯誤還是警告

嚴重錯誤

嚴重錯誤指出雲端基礎結構專案設定中的Commerce發生問題，而造成部署失敗，例如錯誤、不受支援或遺失必要設定的設定。在部署之前，您必須更新設定以解決這些錯誤。

建置階段

錯誤碼

建置步驟

錯誤說明（標題）

建議的動作

無法寫入./app/etc/env.php檔案

部署指令碼無法對/app/etc/env.php檔案進行必要的變更。檢查您的檔案系統許可權。

未在schema.yaml檔案中定義設定

未在./vendor/magento/ece-tools/config/schema.yaml檔案中定義設定。檢查設定變數名稱是否正確且已定義。

無法剖析.magento.env.yaml檔案

./.magento.env.yaml檔案格式無效。使用YAML剖析器來檢查語法並修正任何錯誤。

無法讀取.magento.env.yaml檔案

無法讀取./.magento.env.yaml檔案。檢查檔案許可權。

無法讀取.schema.yaml檔案

無法讀取./vendor/magento/ece-tools/config/magento.env.yaml檔案。檢查檔案許可權並重新部署(magento-cloud environment:redeploy)。

refresh-modules

無法寫入./app/etc/config.php檔案

部署指令碼無法對/app/etc/config.php檔案進行必要的變更。檢查您的檔案系統許可權。

validate-config

無法讀取composer.json檔案

無法讀取./composer.json檔案。檢查檔案許可權。

validate-config

composer.json檔案遺失必要的自動載入區段

composer.json檔案中缺少必要的autoload區段。比較自動載入區段與雲端範本中的composer.json檔案，並新增缺少的設定。

validate-config

.magento.env.yaml檔案包含未在結構描述中宣告的選項，或是設定了無效值或階段的選項

./.magento.env.yaml檔案包含無效的設定。檢查錯誤記錄檔以取得詳細資訊。

refresh-modules

命令失敗： /bin/magento module:enable --all

嘗試在本機執行composer update。然後，認可並推播更新的composer.lock檔案。另外，請檢視cloud.log以取得詳細資訊。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

套用修補程式

無法套用修補程式

set-report-dir-nesting-level

無法寫入檔案/pub/errors/local.xml

copy-sample-data

無法複製範例資料檔案

compile-di

命令失敗： /bin/magento setup:di:compile

如需詳細資訊，請檢視cloud.log。將VERBOSE_COMMANDS: '-vvv'新增至.magento.env.yaml，以取得更詳細的命令輸出。

傾印 — 自動載入

命令失敗： composer dump-autoload

composer dump-autoload命令失敗。如需詳細資訊，請檢視cloud.log。

run-baler

執行Javascript套件組合Baler的命令失敗

檢查SCD_USE_BALER環境變數，確認已設定並啟用JS套件組合的Baler模組。如果您不需要Baler模組，請設定SCD_USE_BALER: false。

compress-static-content

找不到必要的公用程式（逾時、bash）

deploy-static-content

命令/bin/magento setup:static-content:deploy失敗

如需詳細資訊，請檢視cloud.log。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

compress-static-content

靜態內容壓縮失敗

如需詳細資訊，請檢視cloud.log。

backup-data： static-content

無法將靜態內容複製到init目錄中

如需詳細資訊，請檢視cloud.log。

backup-data： writable-dirs

無法將部分可寫入的目錄複製到init目錄

無法將可寫入的目錄複製到./init資料夾。檢查您的檔案系統許可權。

無法建立記錄器物件

backup-data： static-content

無法清除./init/pub/static/目錄

無法清除./init/pub/static資料夾。檢查您的檔案系統許可權。

找不到撰寫器套件

如果您直接從GitHub存放庫安裝Adobe Commerce應用程式版本，請確認已設定DEPLOYED_MAGENTO_VERSION_FROM_GIT環境變數。

validate-config

移除Adobe Commerce和Magento 2.4及更高版本不再支援的Magento Open SourceBraintree模組設定。

Magento2.4.0及更新版本不再支援Braintree模組。從.magento.app.yaml檔案的變數區段中移除CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL變數。如需Braintree付款支援，請改用Commerce Marketplace的正式副檔名。

部署階段

錯誤碼

部署步驟

錯誤說明（標題）

建議的動作

101

預先部署：快取

不正確的快取設定（遺失連線埠或主機）

快取設定遺漏必要的引數server或port。如需詳細資訊，請檢視cloud.log。

102

無法寫入./app/etc/env.php檔案

部署指令碼無法對/app/etc/env.php檔案進行必要的變更。檢查您的檔案系統許可權。

103

未在schema.yaml檔案中定義設定

未在./vendor/magento/ece-tools/config/schema.yaml檔案中定義設定。檢查設定變數名稱是否正確，以及是否已定義。

104

無法剖析.magento.env.yaml檔案

未在./vendor/magento/ece-tools/config/schema.yaml檔案中定義設定。檢查設定變數名稱是否正確，以及是否已定義。

105

無法讀取.magento.env.yaml檔案

無法讀取./.magento.env.yaml檔案。檢查檔案許可權。

106

無法讀取.schema.yaml檔案

107

預先部署： clean-redis-cache

無法清除Redis快取

無法清除Redis快取。檢查Redis快取設定是否正確，以及Redis服務是否可用。請參閱安裝Redis服務。

108

預先部署：set-production-mode

命令/bin/magento maintenance:enable失敗

如需詳細資訊，請檢視cloud.log。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

109

validate-config

不正確的資料庫設定

檢查DATABASE_CONFIGURATION環境變數是否已正確設定。

110

validate-config

不正確的工作階段設定

檢查SESSION_CONFIGURATION環境變數是否已正確設定。組態至少必須包含save引數。

111

validate-config

不正確的搜尋設定

檢查SEARCH_CONFIGURATION環境變數是否已正確設定。組態至少必須包含engine引數。

112

validate-config

資源設定不正確

檢查RESOURCE_CONFIGURATION環境變數是否已正確設定。組態必須包含至少connection個引數。

113

validate-config：elasticsuite-integrity

ElasticSuite已安裝，但Elasticsearch服務無法使用

檢查SEARCH_CONFIGURATION環境變數是否已正確設定，並驗證Elasticsearch服務是否可用。

114

validate-config：elasticsuite-integrity

ElasticSuite已安裝，但使用的是其他搜尋引擎

ElasticSuite已安裝，但已設定其他搜尋引擎。更新SEARCH_CONFIGURATION環境變數以啟用Elasticsearch，並驗證services.yaml檔案中的Elasticsearch服務組態。

115

資料庫查詢執行失敗

116

install-update： setup

命令/bin/magento setup:install失敗

如需詳細資訊，請檢視cloud.log和install_upgrade.log。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

117

install-update： config-import

命令app:config:import失敗

如需詳細資訊，請檢視cloud.log。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

118

找不到必要的公用程式（逾時、bash）

119

install-update： deploy-static-content

命令/bin/magento setup:static-content:deploy失敗

如需詳細資訊，請檢視cloud.log。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

120

compress-static-content

靜態內容壓縮失敗

如需詳細資訊，請檢視cloud.log。

121

deploy-static-content：generate

無法更新已部署的版本

無法更新./pub/static/deployed_version.txt檔案。檢查您的檔案系統許可權。

122

clean-static-content

無法清除靜態內容檔案

123

install-update： split-db

命令/bin/magento setup:db-schema:split失敗

如需詳細資訊，請檢視cloud.log。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

124

clean-view-preprocessed

無法清除var/view_preprocessed資料夾

無法清除./var/view_preprocessed資料夾。檢查您的檔案系統許可權。

125

install-update： reset-password

無法更新/var/credentials_email.txt檔案

無法更新/var/credentials_email.txt檔案。檢查您的檔案系統許可權。

126

install-update： update

命令/bin/magento setup:upgrade失敗

如需詳細資訊，請檢視cloud.log和install_upgrade.log。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

127

clean-cache

命令/bin/magento cache:flush失敗

如需詳細資訊，請檢視cloud.log。如需更詳細的命令輸出，請將VERBOSE_COMMANDS: '-vvv'選項新增至.magento.env.yaml檔案。

128

disable-maintenance-mode

命令/bin/magento maintenance:disable失敗

如需詳細資訊，請檢視cloud.log。將VERBOSE_COMMANDS: '-vvv'新增至.magento.env.yaml，以取得更詳細的命令輸出。

129

install-update： reset-password

無法讀取重設密碼範本

130

install-update： cache_type

命令失敗： php ./bin/magento cache:enable

命令php ./bin/magento cache:enable只有在安裝Adobe Commerce時執行，但在部署開始時有./app/etc/env.php檔案不存在或空白。如需詳細資訊，請檢視cloud.log。將VERBOSE_COMMANDS: '-vvv'新增至.magento.env.yaml，以取得更詳細的命令輸出。

131

install-update

crypt/key機碼值不存在於./app/etc/env.php檔案或CRYPT_KEY雲端環境變數中

如果Adobe Commerce部署開始時./app/etc/env.php檔案不存在，或未定義crypt/key值，便會發生此錯誤。如果您從其他環境移轉資料庫，請擷取該環境的加密金鑰值。然後，將值新增至您目前環境中的CRYPT_KEY雲端環境變數。請參閱Adobe Commerce加密金鑰。如果您不小心移除了./app/etc/env.php檔案，請使用下列命令，從先前部署建立的備份檔案還原： ./vendor/bin/ece-tools backup:restore CLI命令。」

132

無法連線到Elasticsearch服務

檢查有效的Elasticsearch認證，並確認服務執行中

137

無法連線到OpenSearch服務

檢查有效的OpenSearch認證，並確認服務執行中

133

validate-config

移除Adobe Commerce或Magento 2.4及更高版本不再支援的Magento Open SourceBraintree模組設定。

Adobe Commerce或Magento Open Source 2.4.0和更新版本不再支援Braintree模組。從.magento.app.yaml檔案的變數區段中移除CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL變數。如需Braintree支援，請改用Commerce Marketplace的官方Braintree付款擴充功能。

134

validate-config

Adobe Commerce和Magento Open Source 2.4.0需要安裝Elasticsearch服務

安裝Elasticsearch服務

138

validate-config

Adobe Commerce和Magento Open Source 2.4.4需要安裝OpenSearch或Elasticsearch服務

安裝OpenSearch服務

135

validate-config

Adobe Commerce的搜尋引擎必須設為Elasticsearch，且Magento Open Source>= 2.4.0

檢查engine選項的SEARCH_CONFIGURATION變數。如果已設定，請移除選項，或將值設為「elasticsearch」。

136

validate-config

從Adobe Commerce和Magento Open Source2.5.0開始移除分割資料庫。

如果您使用分割資料庫，則必須回覆或移轉至單一資料庫，或使用替代方法。

139

validate-config

不正確的搜尋引擎

此Adobe Commerce或Magento Open Source版本不支援OpenSearch。您必須使用2.3.7-p3、2.4.3-p2或更新版本

Post — 部署階段

錯誤碼

Post — 部署步驟

錯誤說明（標題）

建議的動作

201

is-deploy-failed

部署階段失敗

202

./app/etc/env.php檔案不可寫入

部署指令碼無法對/app/etc/env.php檔案進行必要的變更。檢查您的檔案系統許可權。

203

未在schema.yaml檔案中定義設定

未在./vendor/magento/ece-tools/config/schema.yaml檔案中定義設定。檢查設定變數名稱是否正確，以及是否已定義。

204

無法剖析.magento.env.yaml檔案

./.magento.env.yaml檔案格式無效。使用YAML剖析器來檢查語法並修正任何錯誤。

205

無法讀取.magento.env.yaml檔案

檢查檔案許可權。

206

無法讀取.schema.yaml檔案

207

熱身

無法預先載入某些熱身頁面

208

第一位元組時間

無法測試到第一個位元組的時間(TTFB)

227

clean-cache

命令/bin/magento cache:flush失敗

如需詳細資訊，請檢視cloud.log。將VERBOSE_COMMANDS: '-vvv'新增至.magento.env.yaml，以取得更詳細的命令輸出。

一般

錯誤碼

一般步驟

錯誤說明（標題）

建議的動作

243

未在schema.yaml檔案中定義設定

檢查設定變數名稱是否正確，以及它是否已定義。

244

無法剖析.magento.env.yaml檔案

./.magento.env.yaml檔案格式無效。使用YAML剖析器來檢查語法並修正任何錯誤。

245

無法讀取.magento.env.yaml檔案

無法讀取./.magento.env.yaml檔案。檢查檔案許可權。

246

無法讀取.schema.yaml檔案

247

無法產生用於事件的模組

如需詳細資訊，請檢視cloud.log。

248

無法啟用模組以進行事件

如需詳細資訊，請檢視cloud.log。

249

無法產生AdobeCommerceWebhookPlugins模組

如需詳細資訊，請檢視cloud.log。

250

無法啟用AdobeCommerceWebhookPlugins模組

如需詳細資訊，請檢視cloud.log。

警告錯誤

警告錯誤指出雲端基礎結構專案設定上的Commerce發生問題，例如不正確、已棄用、不支援或遺失可能影響網站作業的選用功能的設定值。雖然警告不會導致部署失敗，但您應檢閱警告訊息並更新設定以解決問題。

建置階段

錯誤碼

建置步驟

錯誤說明（標題）

建議的動作

1001

validate-config

檔案app/etc/config.php不存在

1002

validate-config

「」。不再支援/build_options.ini檔案

1003

validate-config

共用設定檔案中缺少模組區段

1004

validate-config

此設定與此版本的Magento不相容

1005

validate-config

已忽略SCD選項

1006

validate-config

設定的狀態不理想

1007

run-baler

無法使用Baler JS套裝

部署階段

錯誤碼

部署步驟

錯誤說明（標題）

建議的動作

2001

預先部署：快取

快取設定用於無法使用的Redis服務。將忽略設定。

2002

validate-config

設定的狀態不理想

2003

validate-config

尚未設定錯誤報告的目錄巢狀層級值

2004

validate-config

中的設定無效。/pub/errors/local.xml檔案。

2005

validate-config

管理資料僅在初始安裝期間用於建立管理使用者。在升級程式期間，將忽略對管理員資料所做的任何變更。

初始安裝後，您可以從設定中移除管理員資料。

2006

validate-config

未建立管理員使用者，因為未設定管理員電子郵件

安裝後，您可以手動建立管理員使用者：使用ssh連線至您的環境。然後，執行bin/magento admin:user:create命令。

2007

validate-config

將php版本更新至建議的版本

2008

validate-config

Adobe Commerce和Magento Open Source 2.1已不再支援Solr。

2009

validate-config

Adobe Commerce和Magento Open Source 2.2或更新版本不再支援Solr。

2010

validate-config

Elasticsearch服務安裝在基礎建設層，但並未作為搜尋引擎使用。

請考慮從基礎結構層移除Elasticsearch服務，以最佳化資源使用。

2011

validate-config

基礎結構層上的Elasticsearch服務版本與您的Adobe Commerce應用程式所使用之elasticsearch/elasticsearch模組的目前版本不相容。

2012

validate-config

目前的設定與此版本的Adobe Commerce不相容

2013

validate-config

已忽略SCD選項，因為部署程式未在建置階段執行

2014

validate-config

此設定包含過時的變數或值

2015

validate-config

環境設定無效

2016

validate-config

JSON型別設定無法解碼

2017

validate-config

目前的設定與此版本的Adobe Commerce不相容

2018

validate-config

部分服務已通過EOL

2019

validate-config

MySQL搜尋組態選項已過時

請改用Elasticsearch。

2029

validate-config

分割資料庫在Adobe Commerce和Magento Open Source2.4.2中已過時，將在2.5中移除。

如果您使用分割資料庫，您應該開始計畫回覆或移轉至單一資料庫，或使用替代方法。

2020

install-update

Adobe Commerce安裝完成，但app/etc/env.php設定檔遺失或空白。

必要的資料將從環境設定和.magento.env.yaml檔案中還原。

2021

install-update：db-connection

用於使用自訂連線的分割資料庫

2022

install-update：db-connection

您已經變更為與從屬連線不相容的資料庫設定。

2023

install-update：split-db

將略過啟用分割資料庫。

2024

install-update：split-db

SPLIT_DB變數缺少分割連線對型別的組態。

2025

install-update：split-db

未設定從屬連線。

2026

預先部署：restore-writable-dirs

無法將建置階段期間產生的部分資料還原至掛載的目錄

如需詳細資訊，請檢視cloud.log。

2027

validate-config：mage-mode-variable

不支援MAGE_MODE環境變數的模式值

移除MAGE_MODE環境變數，或將其值變更為「生產」。雲端基礎結構上的Adobe Commerce僅支援「生產」模式。

2028

遠端儲存

無法啟用遠端儲存。

驗證遠端儲存憑證。

2030

validate-config

Elasticsearch和OpenSearch服務都安裝在基礎建設層。 Adobe Commerce和Magento Open Source 2.4.4及更新版本預設使用OpenSearch

請考慮從基礎結構層移除Elasticsearch或OpenSearch服務，以最佳化資源使用。

Post — 部署階段

錯誤碼

Post — 部署步驟

錯誤說明（標題）

建議的動作

3001

validate-config

Adobe Commerce已啟用除錯記錄

若要節省磁碟空間，請勿為您的生產環境啟用偵錯記錄。

3002

熱身

無法擷取存放區url

3003

熱身

無法擷取存放區URL

3004

備份

無法建立備份檔案

一般

錯誤碼

一般步驟

錯誤說明（標題）

建議的動作

4001

無法取得系統處理器計數：

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26