HTTP Access Service Error Codes
When using TCB, you may encounter various errors. This section will introduce common error codes and how to troubleshoot them.
General Errors
| Error Code | Meaning |
|---|---|
| BAD_REQUEST | The request data or parameter format is invalid. Please check whether the access domain or Host is correctly filled in, and whether the request header and request body are properly set. |
| INVALID_REQUEST | The HTTP request does not comply with protocol specifications, or the request parameters are abnormal. |
| ENV_ABNORMAL | Environment status is abnormal. Please check whether the cloud hosting service and version status are normal. |
| INVALID_ENV | The environment ID is invalid or no corresponding TCB environment was found |
| ENV_NOT_READY | The environment resources are not ready yet. Please check whether the environment has been initialized. |
| ENV_FEATURE_NOT_CONFIGURED | The target resource for access does not exist in the environment. |
| INVALID_HOST | Invalid or illegal hostname, possibly due to incorrect domain name entry or DNS resolution issues |
| INVALID_PATH | No matching forwarding rule found. Please check the forwarding rule configuration of the HTTP access service. |
| SERVICE_FORBIDDEN | Service is forbidden, possibly due to permission disabled, environment abnormal, or WeChat Cloud Hosting starting up. |
| HTTPSERVICE_NONACTIVATED | HTTP access service is not enabled |
| EXCEED_RATELIMIT | Request rate exceeds the QPS quota of the purchased package |
| EXCEED_MAX_PAYLOAD_SIZE | Request body size exceeds the limit (6MB for cloud functions, 100MB for others) |
| BAD_GATEWAY | An error occurred during gateway transmission, and the request forwarding failed |
| ERR_ABORT_HANDLER | Request processing was aborted, commonly occurs in large model invocations or SSE connection issues |
| DEFAULT_DOMAIN_EXPIRED | The default domain has expired and needs to be renewed or bound to a custom domain |
Authentication and Authorization Errors
| Error Code | Meaning |
|---|---|
| MISSING_CREDENTIALS | The request header is missing required authentication credentials |
| INVALID_CREDENTIALS | Authentication failed: user credentials verification failed |
| ACCESS_TOKEN_EXPIRED | The authentication information in the request header has expired |
| ACCESS_TOKEN_INVALID | The authentication credentials in the request header are invalid |
| ACTION_FORBIDDEN | The current identity is not authorized to perform this operation |
| UNSUPPORTED_AUTH_TYPE | The request uses an unsupported authentication type |
| AUTHENTICATION_FAILED | Request authentication failed |
Cloud Hosting Related Errors
| Error Code | Meaning |
|---|---|
| SERVICE_NOT_FOUND | Could not find the corresponding cloud hosting service |
| SERVICE_RESOURCE_NOT_FOUND | The corresponding resource could not be found. Please check the service and version status |
| SERVICE_VERSION_NOT_FOUND | Could not find the matching cloud hosting service version |
| SERVICE_ENDPOINT_NOT_FOUND | No available upstream endpoint found for the cloud hosting service |
| SERVICE_LB_STATUS_ABNORMAL | Cloud hosting load balancing status is abnormal |
| SERVICE_CHARGE_OVERDUE | Service suspended due to arrears. Please top up promptly |
| SERVICE_NOT_READY | The cloud hosting service is in an unready state, possibly undergoing a cold start |
| SERVICE_TIMEOUT | Cloud hosting service response timeout |
Cloud Function Related Errors
| Error Code | Meaning |
|---|---|
| FUNCTION_NOT_FOUND | Could not find the corresponding cloud function |
| FUNCTION_INVOCATION_FAILED | Cloud function invocation timed out or failed |
| FUNCTION_QUALIFIER_NOT_FOUND | Specified function version not found |
| FUNCTION_STATUS_ABNORMAL | Function status abnormal |
| FUNCTION_TIME_LIMIT_EXCEEDED | Function execution timeout |
| FUNCTION_MEMORY_LIMIT_EXCEEDED | Function execution memory exceeds the limit |
| FUNCTION_EXECUTE_FAIL | Function execution failed |
| FUNCTION_PARAM_INVALID | Function parameter exception |
| FUNCTION_EXCEED_RESOURCE_LIMIT | Request frequency exceeds the function's provisioned concurrency |
Static Hosting Related Errors
| Error Code | Meaning |
|---|---|
| STATIC_RESOURCE_NONACTIVATED | Static website hosting service not enabled |
| STATIC_RESOURCE_TOO_MANY_REDIRECTS | Too many request redirections; a redirect loop may exist |
| STATIC_RESOURCE_REQUESTS_FAILED | Static hosting resource request failed |
Cloud Storage Related Errors
| Error Code | Meaning |
|---|---|
| STORAGE_EXCEED_AUTHORITY | Unauthorized to perform the operation on this object |
| OBJECT_NOT_EXIST | The requested object does not exist, and the specified operation cannot be performed |
| OBJECT_ALREADY_EXIST | The object already exists and the specified operation cannot be performed |
| COS_ACTION_FAILED | Object storage operation failed |
| CDN_SIGNATURE_MISSING | The signature for the current access link is missing |
| CDN_INVALID_SIGNATURE | The signature for the current access link is invalid |
| CDN_SIGNATURE_EXPIRED | The signature for the current access link has expired |
Large Model Invocation Related Errors
| Error Code | Meaning |
|---|---|
| AI_MODEL_NOT_FOUND | The specified model group could not be found |
| AI_MODEL_CONFIG_MISSING | Missing necessary configurations such as API Key for invoking the model |
| AI_MODEL_REQUEST_FAILED | Request to large model failed |
| AI_MODEL_DISABLED | The model has been disabled |
| EXCEED_CONCURRENT_REQUEST_LIMIT | Invoking the large model exceeds the concurrent limit |
| EXCEED_TOKEN_QUOTA_LIMIT | The large model Token usage has exceeded the quota |
System Errors
| Error Code | Meaning |
|---|---|
| INTERNAL_REQUEST_FAIL | Internal system request error |
| SYS_ERR | Internal System Error |