Overview
When using CloudBase, you may encounter various errors. This section introduces common error codes and how to resolve them.
General Errors
| Error Code | Description |
|---|---|
| SYS_ERR | System internal exception |
| SERVER_TIMEOUT | Service response timeout |
| INVALID_APPID | Invalid AppId (WeChat appId or Tencent Cloud appId) |
| INVALID_ACTION | Invalid API call name |
| EXCEED_REQUEST_SIZE_LIMIT | Request packet size exceeds limit |
| EXCEED_RATELIMIT | Request frequency exceeds package resource limit |
| INVALID_REQUEST_SOURCE | Invalid request source, please check WEB security domain configuration |
| INVALID_COMMON_PARAM | Request common parameter error |
| INVALID_PARAM | Request parameter error |
| SIGN_PARAM_INVALID | Invalid authentication parameter |
| LOGIN_MANNER_UNREGISTED | The login method used has been disabled |
| APP_SIGN_EXPIRED | Mobile application signature expired |
| INVALID_APP_SIGN | Invalid mobile application signature, signature format error |
| INVALID_APP_ACCESS | Invalid mobile application access, mobile application version not found |
| CHECK_LOGIN_FAILED | Login state verification failed, access token expired (legacy) |
| ACCESS_TOKEN_EXPIRED | Access token has expired |
| REFRESH_TOKEN_EXPIRED | Refresh token has expired or does not exist |
| INVALID_REFRESH_TOKEN | Invalid refresh token |
| REFRESH_TOKEN_EXHAUSTED | Multi-point login limit exceeded |
| INVALID_ENV | Invalid environment, environment not found |
| INVALID_ENV_STATUS | Invalid environment status, unavailable |
| INVALID_ENV_SOURCE | Mini program bound CloudBase environment source is invalid |
| RESOURCE_NOT_INITIAL | Cloud resource initialization incomplete, cloud resource unavailable |
| EXCEED_REQUEST_LIMIT | Request count limit exceeded, package resources exhausted |
| EXCEED_CONCURRENT_REQUEST_LIMIT | Request concurrency limit exceeded |
| INVALID_OPERATION | Invalid operation, current state (resource, account, etc.) does not allow corresponding operation |
| INVALID_THIRDAPP_STATUS | Bound third-party mini program status abnormal |
| RESOURCE_NOT_FOUND | Resource not found |
| EXCEED_MAX_RESPONSE_SIZE | Maximum response size exceeded |
| INVALID_REGION | Invalid region |
| INVALID_HOST | Invalid host |
| REQUEST_CANCELED | Request was canceled |
| REQUEST_FORBIDDEN | Request is forbidden to access |
| EXCEED_AUTHORITY | Authority limit exceeded |
| RequestLimitExceeded | Request limit exceeded |
| INVALID_REQUEST | HTTP request does not conform to protocol specification, or request parameter exception |
| BAD_REQUEST | Bad request, request aborted or invalid JSON received |
| PERMISSION_DENIED | Permission denied, unauthenticated access or insufficient permissions |
| ENV_ABNORMAL | Environment status abnormal, please check if CloudRun service and version status are normal |
| ENV_NOT_READY | Environment resources are not ready yet, please check if environment initialization is complete |
| ENV_FEATURE_NOT_CONFIGURED | Target resource accessed does not exist in environment |
| INVALID_PATH | No matching forwarding rule found, please check HTTP access service forwarding rule configuration |
| SERVICE_FORBIDDEN | Service is disabled, may be due to permission closure, environment exception, or WeChat CloudRun starting |
| HTTPSERVICE_NONACTIVATED | HTTP access service not enabled |
| EXCEED_MAX_PAYLOAD_SIZE | Request body size exceeds limit (Cloud Function 6MB, others 100MB) |
| BAD_GATEWAY | Gateway transmission error occurred, request forwarding failed |
| ERR_ABORT_HANDLER | Request processing interrupted, common in large model calls or SSE connection issues |
| DEFAULT_DOMAIN_EXPIRED | Default domain has exceeded usage validity period, requires renewal or bind custom domain |
| INTERNAL_REQUEST_FAIL | System internal request error |
Authentication Errors
| Error Code | Description |
|---|---|
| AUTH_INVALID_CUSTOM_LOGIN_TICKET | Invalid custom login credential (format error, expired, validation failed, etc.) |
| AUTH_WX_OAUTH_FAILED | WeChat OAuth failed |
| AUTH_CUSTOM_USER_ID_HAS_BEEN_BOUND | CustomUserId is already associated with account |
| AUTH_OPEN_ID_HAS_BEEN_BOUND | openId is already associated with account |
| AUTH_UNION_ID_HAS_BEEN_BOUND | unionId is already associated with account |
| AUTH_EMAIL_HAS_BEEN_BOUND | email is already associated with account |
| INVALID_EMAIL_TOKEN | Email activation token expired or does not exist |
| AUTH_LOGIN_FAILED | Login failed |
| INVALID_ACCESS_TOKEN | Invalid access token |
| ACCESS_TOKEN_DISABLED | Access token has been disabled |
| REFRESH_TOKEN_DISABLED | Refresh token has been disabled |
| PHONE_CODE_NOT_MATCHED | Phone verification code does not match |
| PHONE_CODE_NOTFOUND_OR_EXPIRED | Phone verification code not found or expired |
| PHONE_CODE_SEND_LIMIT_EXCEED | Phone verification code send limit exceeded |
| MISSING_CREDENTIALS | Missing necessary authentication information in request header |
| INVALID_CREDENTIALS | Authentication failed, user information validation failed |
| ACCESS_TOKEN_INVALID | Authentication information in request header is invalid |
| ACCESS_TOKEN_KID_INVALID | Access token Key ID (kid) is invalid |
| ACTION_FORBIDDEN | Current identity has no permission to execute this operation |
| WX_WEBSOCKET_TOKEN_EXPIRED | WeChat WebSocket connection token has expired |
| WX_HEADER_GET_FAILED | Failed to get WeChat request header |
| UNSUPPORTED_AUTH_TYPE | Request uses unsupported authentication type |
| AUTHENTICATION_FAILED | Request authentication failed |
Database Errors
| Error Code | Description |
|---|---|
| DATABASE_REQUEST_FAILED | Database request failed, database general error |
| DATABASE_INVALID_OPERRATOR | Unsupported operation, invalid database operator |
| DATABASE_PERMISSION_DENIED | No permission to operate database resource |
| DATABASE_COLLECTION_EXCEED_LIMIT | Database collection count limit exceeded |
| DATABASE_COLLECTION_NOT_EXIST | Operation collection does not exist |
| DATABASE_COLLECTION_ALREADY_EXIST | Collection already exists when creating collection |
| DATABASE_TIMEOUT | Database request timeout |
| DATABASE_TRANSACTION_FAIL | Database transaction request failed |
| DATABASE_TRANSACTION_CONFLICT | Conflict between database transactions |
| DATABASE_DUPLICATE_WRITE | Database write failed, index key duplicate (e.g., inserting data with same _id) |
Cloud Function Errors
| Error Code | Description |
|---|---|
| FUNCTIONS_EXECUTE_FAIL | Cloud function execution failed, cloud function general error |
| FUNCTIONS_TIME_LIMIT_EXCEEDED | Cloud function execution timeout |
| FUNCTIONS_MEMORY_LIMIT_EXCEEDED | Cloud function running memory limit exceeded |
| FUNCTION_NOT_FOUND | Cloud function not found |
| FUNCTIONS_STATUS_ABNORMITY | Cloud function status abnormal |
| FUNCTION_INVOCATION_FAILED | Calling cloud function timeout or failed |
| FUNCTION_QUALIFIER_NOT_FOUND | Specified function version to access does not exist |
| FUNCTION_STATUS_ABNORMAL | Function status abnormal |
| FUNCTION_TIME_LIMIT_EXCEEDED | Function execution timeout |
| FUNCTION_MEMORY_LIMIT_EXCEEDED | Function execution memory limit exceeded |
| FUNCTION_EXECUTE_FAIL | Execute function failed |
| FUNCTION_PARAM_INVALID | Parameter exception when calling function |
| FUNCTION_EXCEED_RESOURCE_LIMIT | Request frequency exceeds function provisioned concurrency |
CloudRun Related Errors
| Error Code | Description |
|---|---|
| SERVICE_NOT_FOUND | Corresponding CloudRun service not found |
| SERVICE_RESOURCE_NOT_FOUND | Corresponding resource not found, please check service and version status |
| SERVICE_VERSION_NOT_FOUND | Cannot find matching CloudRun service version |
| SERVICE_ENDPOINT_NOT_FOUND | Cannot find available upstream address for CloudRun service |
| SERVICE_LB_STATUS_ABNORMAL | CloudRun load balancer status abnormal |
| SERVICE_CHARGE_OVERDUE | Service suspended due to overdue payment, please recharge in time |
| SERVICE_NOT_READY | CloudRun service in not ready state, may be cold starting |
| SERVICE_TIMEOUT | CloudRun service response timeout |
Cloud Storage Errors
| Error Code | Description |
|---|---|
| STORAGE_REQUEST_FAIL | Cloud storage request failed, cloud storage general error |
| EXCEED_UPLOAD_MAXFILESIZE | Cloud storage upload file size limit exceeded |
| STORAGE_SIGN_PARAM_INVALID | Cloud storage file metadata parsing failed |
| STORAGE_EXCEED_AUTHORITY | Current user has no permission to operate cloud storage resource |
| STORAGE_FILE_NONEXIST | Cloud storage file does not exist |
| STORAGE_FILE_PATH_CONFLICT | Cloud storage file path conflict |
| OBJECT_NOT_EXIST | Requested object does not exist, cannot execute specified operation |
| OBJECT_ALREADY_EXIST | Object already exists, cannot execute specified operation |
| OBJECT_BATCH_TOO_LARGE | Too many objects in single batch operation |
| COS_ACTION_FAILED | Object storage operation execution failed |
| CDN_SIGNATURE_MISSING | Signature missing for current access link |
| CDN_INVALID_SIGNATURE | Signature incorrect for current access link |
| CDN_SIGNATURE_EXPIRED | Signature expired for current access link |
Static Hosting Related Errors
| Error Code | Description |
|---|---|
| STATIC_RESOURCE_NONACTIVATED | Static website hosting service not enabled |
| STATIC_RESOURCE_TOO_MANY_REDIRECTS | Too many request redirects, possible redirect loop |
| STATIC_RESOURCE_REQUESTS_FAILED | Request for static hosting resource failed |
Large Model Call Related Errors
| Error Code | Description |
|---|---|
| AI_MODEL_NOT_FOUND | Specified model group not found |
| AI_MODEL_CONFIG_MISSING | Missing necessary configuration for calling model such as API Key |
| AI_MODEL_REQUEST_FAILED | Request to large model failed |
| AI_MODEL_DISABLED | Model has been disabled |
| EXCEED_TOKEN_QUOTA_LIMIT | Large model Token usage has exceeded quota |
| APIs_GET_OPENAPI_SCHEMA_ERROR | Failed to get OpenAPI Schema |
Note
DATABASE_REQUEST_FAILED, STORAGE_REQUEST_FAIL, FUNCTIONS_EXECUTE_FAIL are general database, cloud storage request errors, and cloud function request errors respectively, with no special semantics. More refined error codes with independent characteristic semantics will be introduced in the future. Please avoid making special logic judgments based on these error codes.