Cloud Development Error Codes
tip
🌟 Having issues with CloudBase? Click here to consult Cloud Development Copilot, which is ready to answer your questions anytime. 📱 WeChat CloudBase users please log in via Mini Program Official Account.
General Errors
| Error Code | Description |
|---|---|
| SYS_ERR | Internal system exception |
| SERVER_TIMEOUT | Service response timeout |
| INVALID_APPID | Invalid AppId (WeChat appId or Tencent Cloud appId) |
| - | - |
| INVALID_ACTION | The invoked interface name is invalid |
| EXCEED_REQUEST_SIZE_LIMIT | Request packet size exceeds the limit |
| EXCEED_RATELIMIT | Request frequency exceeds the service plan's resource limit |
| INVALID_REQUEST_SOURCE | Invalid request source. Check the WEB Security Domain Configuration and other settings. |
| 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 or malformed mobile application signature |
| INVALID_APP_ACCESS | Invalid mobile application access or mobile application version not found |
| CHECK_LOGIN_FAILED | Login status verification failed, access token expired (deprecated) |
| ACCESS_TOKEN_EXPIRED | access token expired |
| REFRESH_TOKEN_EXPIRED | refresh token expired or does not exist |
| INVALID_REFRESH_TOKEN | Invalid refresh token |
| REFRESH_TOKEN_EXHAUSTED | Concurrent login limit exceeded |
| INVALID_ENV | Invalid environment or environment not found |
| INVALID_ENV_STATUS | Invalid environment status, unavailable |
| INVALID_ENV_SOURCE | Invalid source for Mini Program-bound CloudBase environment |
| RESOURCE_NOT_INITIAL | Cloud resources not initialized or unavailable |
| EXCEED_REQUEST_LIMIT | Number of requests exceeds the limit or service plan resources exhausted |
| EXCEED_CONCURRENT_REQUEST_LIMIT | Concurrent request limit exceeded |
| INVALID_OPERATION | Invalid operation: the current state (resources, accounts, etc.) does not allow this operation |
| PERMISSION_DENIED | Operation not permitted |
| INVALID_THIRDAPP_STATUS | Invalid bound third-party Mini Program status |
Login Authentication
| Error Code | Description |
|---|---|
| AUTH_INVALID_CUSTOM_LOGIN_TICKET | Custom login ticket invalid (incorrect format, expired, verification failed, etc.) |
| AUTH_WX_OAUTH_FAILED | WeChat OAuth failed |
| AUTH_CUSTOM_USER_ID_HAS_BEEN_BOUND | CustomUserId has been bound to an account |
| AUTH_OPEN_ID_HAS_BEEN_BOUND | openId has been bound to an account |
| AUTH_UNION_ID_HAS_BEEN_BOUND | unionId has been bound to an account |
| AUTH_EMAIL_HAS_BEEN_BOUND | email has been bound to an account |
| INVALID_EMAIL_TOKEN | Email activation token expired or does not exist |
| AUTH_LOGIN_FAILED | Login failed |
Cloud Database
| Error Code | Description |
|---|---|
| DATABASE_REQUEST_FAILED | Cloud database request failed: generic error |
| DATABASE_INVALID_OPERRATOR | Unsupported operation, invalid database operator |
| DATABASE_PERMISSION_DENIED | Permission denied to access cloud database resources |
| DATABASE_COLLECTION_EXCEED_LIMIT | Cloud database collection limit exceeded |
| DATABASE_COLLECTION_NOT_EXIST | Collection does not exist |
| DATABASE_COLLECTION_ALREADY_EXIST | Collection already exists during creation |
| DATABASE_TIMEOUT | Cloud database request timeout |
| DATABASE_TRANSACTION_FAIL | Cloud database transaction request failed |
| DATABASE_TRANSACTION_CONFLICT | Cloud database transaction conflict |
| DATABASE_DUPLICATE_WRITE | Database write failed: duplicate key (e.g., inserting data with the same _id) |
Cloud Function
| Error Code | Description |
|---|---|
| FUNCTIONS_EXECUTE_FAIL | Cloud Function execution failed (generic error) |
| FUNCTIONS_TIME_LIMIT_EXCEEDED | Cloud Function execution timeout |
| FUNCTIONS_MEMORY_LIMIT_EXCEEDED | Cloud Function memory limit exceeded |
| FUNCTION_NOT_FOUND | Cloud Function not found |
Cloud Storage
| Error Code | Description |
|---|---|
| STORAGE_REQUEST_FAIL | Cloud Storage request failed: generic error |
| EXCEED_UPLOAD_MAXFILESIZE | Cloud Storage upload file size exceeds the limit |
| STORAGE_SIGN_PARAM_INVALID | Cloud Storage file metadata parsing failed |
| STORAGE_EXCEED_AUTHORITY | The current user has insufficient permissions to operate Cloud Storage resources. Please check the Cloud Storage permission configuration |
| STORAGE_FILE_NONEXIST | Cloud Storage file does not exist |
| STORAGE_FILE_PATH_CONFLICT | Cloud Storage file path conflict |
Note
The DATABASE_REQUEST_FAILED, STORAGE_REQUEST_FAIL, and FUNCTIONS_EXECUTE_FAIL` are generic error codes for cloud database, cloud storage, and cloud function requests respectively. They do not convey specific meanings. In the future, we will refine them into error codes with distinct semantic characteristics. Please avoid implementing special logic based on these error codes.