Cloud Development Error Codes
tip
🌟 Encountering Cloud Development issues? Click here to consult Cloud Development Copilot, ready to answer your questions at any time. 📱 WeChat Cloud Development users, please select the Mini Program Official Account to log in.
General Errors
| Error Code | Meaning |
|---|---|
| SYS_ERR | system internal exception |
| SERVER_TIMEOUT | service response timeout |
| INVALID_APPID | Invalid AppId (WeChat appId or Tencent Cloud appId) |
| - | - |
| INVALID_ACTION | Invalid interface name invoked |
| EXCEED_REQUEST_SIZE_LIMIT | Request packet size limit exceeded |
| EXCEED_RATELIMIT | Request frequency exceeds the plan resource limit |
| INVALID_REQUEST_SOURCE | Invalid request source. Please check the WEB security domain configuration and other configurations. |
| INVALID_COMMON_PARAM | Invalid common parameters |
| INVALID_PARAM | Invalid parameters |
| SIGN_PARAM_INVALID | Invalid authentication parameters |
| LOGIN_MANNER_UNREGISTED | The login method used has been disabled. |
| APP_SIGN_EXPIRED | Mobile application signature expired |
| INVALID_APP_SIGN | Mobile application signature is invalid or malformed |
| INVALID_APP_ACCESS | Invalid mobile application access, mobile application version not found |
| CHECK_LOGIN_FAILED | Login status verification failed, access token expired (legacy) |
| 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 | Multiple logins exceed the allowed number |
| INVALID_ENV | Invalid environment, environment not found |
| INVALID_ENV_STATUS | Invalid or unavailable environment status |
| INVALID_ENV_SOURCE | Invalid source of CloudBase environment bound to Mini Program |
| RESOURCE_NOT_INITIAL | Cloud resources have not been initialized or are unavailable |
| EXCEED_REQUEST_LIMIT | Request limit exceeded, plan resources exhausted |
| EXCEED_CONCURRENT_REQUEST_LIMIT | Concurrent request limit exceeded |
| INVALID_OPERATION | Invalid operation. The current state (of resources, account, etc.) does not allow the corresponding operation. |
| PERMISSION_DENIED | Permission denied |
| INVALID_THIRDAPP_STATUS | Abnormal status of bound third-party Mini Program |
Login Authentication
| Error Code | Meaning |
|---|---|
| AUTH_INVALID_CUSTOM_LOGIN_TICKET | Invalid custom login credentials (malformed, 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 |
Database
| Error Code | Meaning |
|---|---|
| DATABASE_REQUEST_FAILED | Database request failed, generic database error |
| DATABASE_INVALID_OPERRATOR | Unsupported operation, invalid database operator |
| DATABASE_PERMISSION_DENIED | Database operation permission denied |
| DATABASE_COLLECTION_EXCEED_LIMIT | Database collection count exceeds the limit |
| DATABASE_COLLECTION_NOT_EXIST | Collection does not exist |
| DATABASE_COLLECTION_ALREADY_EXIST | Collection already exists when creating a collection |
| DATABASE_TIMEOUT | Database request timeout |
| DATABASE_TRANSACTION_FAIL | Database transaction request failed |
| DATABASE_TRANSACTION_CONFLICT | Transaction conflict |
| DATABASE_DUPLICATE_WRITE | Database write failed, duplicate key (e.g., inserting data with the same _id) |
Cloud Function
| Error Code | Meaning |
|---|---|
| FUNCTIONS_EXECUTE_FAIL | Cloud function execution failed, general cloud function 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 | Meaning |
|---|---|
| STORAGE_REQUEST_FAIL | Cloud storage request failed, generic cloud storage error |
| EXCEED_UPLOAD_MAXFILESIZE | Cloud storage upload file size limit exceeded |
| STORAGE_SIGN_PARAM_INVALID | Cloud storage file metadata parsing failed |
| STORAGE_EXCEED_AUTHORITY | The current user has no permission 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
DATABASE_REQUEST_FAILED, STORAGE_REQUEST_FAIL, and FUNCTIONS_EXECUTE_FAIL are generic database request errors, cloud storage request errors, and cloud function request errors respectively, with no specific semantics. In the future, we will refine error codes with distinct semantic features. Please avoid implementing special logic based on these error codes.