Mobile App FAQs

Mini-Program Loading Error Codes

Unified Text

  • Chinese: 无法打开小程序, 请稍后重试(错误码:100XX)
  • English: Unable to open the Mini-Program, please try again later(error code: 100XX)
Error CodeDescription
10001Basic library download failed
10002Mini-Program base library signature verification failed
10003Mini-Program base library decompression failed
10004Mini-Program code package download failed
10005Mini-Program code package signature verification failed
10006Mini-Program code package decompression failed
10007Mini-Program multi-language download failed
10008Mini-Program view layer JS loading failed
10009Mini-Program uniqueCode information not found
10010Mini-Program information request failed, possibly due to Kit mismatch or whitelist not set
10011Mini-Program object is Null
10012service.js loading failed
10013Mini-Program preload failed (Android)
10014Mini-Program startup process exception
10015Mini-Program webview preload failed
10016Mini-Program base library not downloaded

Miniapp does not exist

This error occurs because the specified miniapp is not found. Make sure the specified miniapp ID is correct.

Miniapp is not associated with an app

  • The association between the app and miniapp is not found.
  • Go to Tuya MiniApp Developer Platform > Distribution and check whether the current app is added to this section. If not, add the app to the app list in the Distribution section.

The trial QR code of my miniapp is invalid

This is because the review request has an error or expired. You must submit the review request again.

No version is available for the current miniapp

  • Go to the Tuya MiniApp Developer Platform and check whether the miniapp has an official version that is in service.
  • If not, release a version and try again.

No trial version is available for the current miniapp

  • This is because the specified trial miniapp is not found. Go to the Tuya MiniApp Developer Platform and check whether the miniapp has a trial version.
  • If not, set the target version to the trial version and open the miniapp.

The specified miniapp version does not exist

This is because the specified miniapp version is not found. Go to the Tuya MiniApp Developer Platform and check whether the miniapp has the specified version.

No access permission for the specified version

  • Your app account is not added to the allowlist of the current miniapp.
  • Go to Tuya MiniApp Developer Platform > Allowlist and add the app account to the allowlist.
  • If the OEM app indicates that the user does not exist, you must add the user identifier. Press and hold the top right corner of the miniapp and find the user identifier in the window that appears.

Miniapp cannot be opened

Make sure the network works fine and try again later.

The current app version does not support the miniapp features

  • The versions of the Kit dependencies for the current app are incompatible with the versions of the Kit dependencies required by the miniapp.
  • Go to the Tuya MiniApp Developer Platform and check the base library version of the miniapp. Tap the icon "x" in the top right corner of the app to check the base library version of the app. Compare these two base library versions. If the base library version bound with the app is later than or equal to the base library version of the miniapp, the miniapp can be started on the app.
  • Go to the Tuya MiniApp Developer Platform and check the Kit versions required by the miniapp. Tap the icon "x" in the top right corner of the app to check the Kit versions of the app. Compare their Kit versions. If each Kit version of the app is later than or equal to that of the miniapp, the miniapp can be started on the app.
  • For more information, see Compatibility.

How do I update the OEM app?

An OEM app of an earlier version cannot load the miniapp. You need to update the app version. Check how to update the app version.

Other problems

To seek support for other types of problems, you can leave messages on Tuya's Developer Forum.