本頁內容適用於 Apigee 和 Apigee Hybrid。
  
    查看 
    Apigee Edge 說明文件。
  
  
       
 
  
Apigee 提供各種功能的錯誤代碼,協助您診斷問題。舉例來說,典型的 4xx 或 5xx HTTP 狀態碼可使用一或多個錯誤代碼分類。
錯誤代碼會提供執行階段錯誤的實用資訊,包括錯誤來源和名稱的資訊,格式如下:[prefix].[error_name]
例如:steps.raisefault.RaiseFault
在這個例子中:
- steps.raisefault前置字串表示 RaiseFault 政策產生錯誤。
- RaiseFault是錯誤名稱,有助於判斷錯誤原因。在這種情況下,錯誤字串會提供更多資訊。
下表依類別和子類別列出故障代碼。
| 類別 | 子類別 | 名稱 | 故障代碼 | 
|---|---|---|---|
| API 通訊協定 | HTTP | HTTP BadFormData | protocol.http.BadFormData | 
| HTTP BadRequestPath | protocol.http.BadPath | ||
| HTTP DuplicateHeader | protocol.http.DuplicateHeader | ||
| HTTP EmptyHeaderName | protocol.http.EmptyHeaderName | ||
| HTTP HeaderNameWithNonASCIICharacter | protocol.http.HeaderNameWithNonAsciiChar | ||
| HTTP HeaderWithInvalidCharacter | protocol.http.HeaderWithInvalidChar | ||
| HTTP InvalidRequestPath | protocol.http.InvalidPath | ||
| HTTP LengthRequired | messaging.adaptors.http.flow.LengthRequired | ||
| HTTP ProxyTunnelCreationFailed | protocol.http.ProxyTunnelCreationFailed | ||
| HTTP RequestHasABigBody | protocol.http.TooBigBody | ||
| HTTP 要求 HaveABigLine | protocol.http.TooBigLine | ||
| HTTP Response306IsReserved | protocol.http.Response306Reserved | ||
| HTTP Response405WithoutAllowHeader | protocol.http.Response405WithoutAllowHeader | ||
| ResponseWithBodyForIncorrectStatusCode | protocol.http.ResponseWithBody | ||
| HTTP TargetURLHasEmptyPath | protocol.http.EmptyPath | ||
| HTTP TooBigHeaders | protocol.http.TooBigHeaders | ||
| HTTP UnsupportedEncoding | protocol.http.UnsupportedEncoding | ||
| 開發人員/應用程式 | 金鑰管理 | KeyManagement AccessTokenNotApproved | keymanagement.service.access_token_not_approved | 
| KeyManagement APIProductNotFound | keymanagement.service.InvalidAPICallAsNoApiProductMatchFound | ||
| KeyManagement AppNotApproved | keymanagement.service.invalid_client-app_not_approved | ||
| KeyManagement AppNotApproved | keymanagement.service.app_not_approved | ||
| KeyManagement AuthorizationCodeExpired | keymanagement.service.access_denied-authorization_code_expired | ||
| KeyManagement AuthorizationCodeinvalid | keymanagement.service.invalid_request-authorization_code_invalid | ||
| KeyManagement ClientIDAuthorizationCodeMismatch | keymanagement.service.invalid_client-client_id_authorzation_code_mismatch | ||
| KeyManagement ClientIDNotApproved | keymanagement.service.invalid_client-client_id_not_approved | ||
| KeyManagement CompanyStatusNotActive | keymanagement.service.CompanyStatusNotActive | ||
| KeyManagement Consumer Key Expired | keymanagement.service.consumer_key_expired | ||
| KeyManagement DeveloperNotActive | keymanagement.service.DeveloperStatusNotActive | ||
| KeyManagement InvalidAccessToken | keymanagement.service.oauth10_access_token_doesnotexist | ||
| KeyManagement InvalidClientID | keymanagement.service.InvalidClientIdForGivenResource | ||
| KeyManagement InvalidClientID | keymanagement.service.invalid_client-client_id_authorzation_code_mismatch | ||
| KeyManagement InvalidClientID | keymanagement.service.invalid_client-invalid_client_id | ||
| KeyManagement InvalidConsumerKey | keymanagement.service.invalid_consumer_key | ||
| KeyManagement InvalidRefreshToken | keymanagement.service.invalid_refresh_token | ||
| KeyManagement RefreshTokenExpired | keymanagement.service.refresh_token_expired | ||
| 擴充功能政策 | JavaCallout | JavaCallout errorname | 請參閱 JavaCallout 政策執行階段錯誤 | 
| JavaScript 標註 | JavaScriptCallout errorname | 請參閱「JavaScript 政策執行階段錯誤」 | |
| MessageLogging | MessageLogging StepDefinitionExecutionFailed | steps.messagelogging.StepDefinitionExecutionFailed | |
| 節點指令碼 | NodeScript ExecutionError | scripts.node.ScriptExecutionError | |
| PythonScript | PythonScript errorname | 請參閱「PythonScript 政策執行階段錯誤」 | |
| 指令碼 | Script EvaluationFailed | steps.script.ScriptEvaluationFailed | |
| ServiceCallout | ServiceCallout errorname | 請參閱「ServiceCallout 政策執行階段錯誤」 | |
| 閘道 | Proxy | Gateway APITimedOut | flow.APITimedOut | 
| Gateway ApplicationNotFound | messaging.adaptors.http.flow.ApplicationNotFound | ||
| Gateway DecompressionFailureAtRequest | messaging.adaptors.http.flow.DecompressionFailureAtRequest | ||
| Gateway DecompressionFailureAtResponse | messaging.adaptors.http.flow.DecompressionFailureAtResponse | ||
| Gateway KeyAliasNotFound | security.util.KeyAliasNotFound | ||
| Gateway RouteToTargetFailed | messaging.runtime.RouteFailed | ||
| Gateway SharedFlowNotFound | flow.SharedFlowNotFound | ||
| Gateway TargetIsMissing | messaging.runtime.TargetMissing | ||
| 目標 | Gateway FailedHandshakeWithTargetEndpoint | messaging.adaptors.http.flow.SslHandshakeFailed | |
| Gateway TimeoutWithTargetOrCallout | messaging.adaptors.http.flow.GatewayTimeout | ||
| Gateway TargetOrCalloutEndpointsNotAvailable | messaging.adaptors.http.flow.ServiceUnavailable | ||
| Gateway TargetServerConfiguredInLoadBalancerIsDown | messaging.adaptors.http.flow.NoActiveTargets | ||
| Gateway UnexpectedEOFAtTarget | messaging.adaptors.http.flow.UnexpectedEOFAtTarget | ||
| 虛擬主機 | VirtualHost InvalidKeystoreOrTrustStore | messaging.runtime.SecurityStoreNotConfigured | |
| VirtualHost SecurityStoreNotConfigured | messaging.runtime.SecurityStoreNotConfigured | ||
| 其他 | Gateway HTTPErrorResponseCode | messaging.adaptors.http.flow.ErrorResponseCode | |
| 中介服務政策 | AssignMessage | AssignMessage errorname | 請參閱「AssignMessage 政策執行階段錯誤」 | 
| ExtractVariables | ExtractVariables errorname | 請參閱「ExtractVariables 政策執行階段錯誤」 | |
| JSONtoXML | JSONtoXML errorname | 請參閱「JSONtoXML 政策執行階段錯誤」 | |
| KeyValueMap | KeyValueMap errorname | 請參閱「KeyValueMapOperations 政策執行階段錯誤」 | |
| MessageValidation | MessageValidation errorname | 請參閱「SOAPMessageValidation 政策執行階段錯誤」 | |
| RaiseFault | RaiseFault RaiseFaultException | steps.raisefault.RaiseFault | |
| XMLtoJSON | XMLtoJSON errorname | 請參閱「XMLtoJSON 政策執行階段錯誤」 | |
| XSLTransformation | XSLTransformation errorname | 請參閱「XSLTransform 政策執行階段錯誤」 | |
| 營利 | Mint UndefinedProduct | mintstep.undefinedProduct | |
| 安全性政策 | AccessControl | AccessControl errorname | 請參閱「AccessControl 政策執行階段錯誤」 | 
| BasicAuthentication | BasicAuthentication errorname | 請參閱「BasicAuthentication 政策執行階段錯誤」 | |
| JSONThreatProtection | JSONThreatProtection errorname | 請參閱「JSONThreatProtection 政策執行階段錯誤」 | |
| JWT | JWT errorname | 請參閱 JWT 政策執行階段錯誤 | |
| OAuth | OAuth errorname | 請參閱 OAuth V2 政策執行階段錯誤 | |
| 規則運算式保護 | RegexProtection errorname | 請參閱「RegularExpressionProtection 政策執行階段錯誤」 | |
| SAMLAssertion | SAMLAssertion InvalidKeyStore | steps.saml.generate.InvalidKeyStore | |
| SAMLAssertion InvalidMediaType | steps.saml.generate.InvalidMediaTpe | ||
| SAMLAssertion InvalidTrustStore | steps.saml.validate.InvalidTrustStore | ||
| SAMLAssertion SAMLAssertionForNotBeforeConditionViolated | steps.saml.validate.NotBeforeConditionViolated | ||
| SAMLAssertion SignatureValidationFailed | steps.saml.validate.SignatureValidationFailed | ||
| SAMLAssertion XPathResolutionFailed | steps.saml.validate.XPathResolutionFailed | ||
| XMLThreatProtection | XMLThreatProtection errorname | 請參閱「XMLThreatProtection 政策執行階段錯誤」 | |
| Sense 功能 | Sense 功能 | Sense RaiseFault | messaging.runtime.SenseRaiseFault | 
| 流量管理政策 | 快取 | Caching InvalidExpiryDatForCacheEntry | messaging.config.beans.InvalidExpiryDateForCacheEntry | 
| ConcurrentRateLimit | ConcurrentRateLimit ConcurrentRateLimitViolation | policies.concurrentratelimit.ConcurrentRatelimitViolation | |
| 配額 | 配額 errorname | 請參閱配額政策執行階段錯誤 | |
| 配額或 SpikeArrest | QuotaOrSpikeArrest InvalidMessageWeight | policies.ratelimit.InvalidMessageWeight | |
| ResetQuota | ResetQuota errorname | 請參閱「重設配額政策執行階段錯誤」 | |
| SpikeArrest | SpikeArrest errorname | 請參閱「SpikeArrest 政策執行階段錯誤」 |