Error Codes

Error CodeDescription
102Error occurred while loading app bundle
105Error occurred while reloading app bundle
201Error occurred while executing background thread script
202Error occurred while calling JS function from platform
301Error occurred while loading image resource
302Error occurred while loading font resource
303Error occurred while loading external resource
304Error occurred while loading i18n resource
321Error occurred while invoking LynxResourceModule
398Custom error for resource
399Exception occurred while loading resource
401Error occurred while updating data
501Error occurred while invoking Element API
502Error occurred while updating element
601Internal layout error
602Performance issues related to layout
603Failed to update layout
604Invalid usage or exceptions on ShadowNode
901Common errors for invoking native modules
998Error occurred in custom native modules
999Exception occurred while invoking the native module
1099Exception occurred while handling event
1101Error occurred while executing Main thread script
1111Error occurred while executing renderer function
1202Running on the wrong thread
1301Generic CSS error
1302Error while manipulating ComputedCSSValue
1303Error occurred while parsing CSS
1601Failed to load a lazy bundle
1901Error for main thread script call exception in worklet
1902Error for requestAnimationFrame call exception
1903Error for worklet module exception
2001Error occurred while calling MTSBridge module
2201Error occurred while invoking component API
2202Error from List component
2203Error from Image component
2298Custom error of components
9901Platform exceptions
9902Exceptions encountered while calling Java native interface

102:EB_APP_BUNDLE_LOAD

10201:E_APP_BUNDLE_LOAD_RENDER_FAILEDFatal

Description: Failed to render app bundle
FixSuggestion: Should not call loadTemplate while the rendering pipeline of app bundle has not finished

10202:E_APP_BUNDLE_LOAD_ENV_NOT_READYFatal

Description: loadTemplate while LynxEnv has not been initialized
FixSuggestion: Please call the initialization method of LynxEnv before loadTemplate

10203:E_APP_BUNDLE_LOAD_BAD_RESPONSEFatal

Description: Failed to fetch app bundle by provider
FixSuggestion: Please check if the app bundle is available

10204:E_APP_BUNDLE_LOAD_PARSE_FAILEDFatal

Description: Failed to parse app bundle
FixSuggestion: Please check that 1. the provided bundle is an app bundle, 2. the engine version of the bundle is compatible with that of Lynx engine, 3. the bundle file is not broken

10205:E_APP_BUNDLE_LOAD_BAD_BUNDLEFatal

Description: A bad TemplateBundle is provided
FixSuggestion: Please check the error message of the bundle

10299:E_APP_BUNDLE_LOAD_EXCEPTIONFatal

Description: Exception occurred while rendering app bundle

105:EB_APP_BUNDLE_RELOAD

10501:E_APP_BUNDLE_RELOAD_EARLY_RELOADError

Description: reloadTemplate before loadTemplate
FixSuggestion: Please loadTemplate before reloadTemplate

201:EB_BTS_RUNTIME_ERROR

20100:E_BTS_RUNTIME_ERRORUndecided

Description: Runtime error for an unspecified reason

20101:E_BTS_RUNTIME_ERROR_SCRIPT_ERRORFatal

Description: The script has syntax errors or other runtime errors
FixSuggestion: Please check the error message and fix the script

20102:E_BTS_RUNTIME_ERROR_BYTECODE_SCRIPT_ERRORFatal

Description: The bytecode script has syntax errors or other runtime errors
FixSuggestion: Please check the error message and fix the script

20103:E_BTS_RUNTIME_ERROR_BINDINGS_ERRORError

Description: JavaScript binding API call errors
FixSuggestion: Please check the error message and fix binding API call

202:EB_BTS_PLATFORM_CALL_JS_FUNCTION

20201:E_BTS_PLATFORM_CALL_JS_FUNCTION_TOO_FREQUENCYWarn

Description: Calling JS function too frequently. This may cause OOM issues
FixSuggestion: Please throttle related calls

301:EB_RESOURCE_IMAGE

30101:E_RESOURCE_IMAGE_BIG_IMAGEError

Description: The image bitmap size is too large relative to the UI.
FixSuggestion: Please resize the image to appropriate dimensions or enable downsampling

30102:E_RESOURCE_IMAGE_PIC_SOURCEError

Description: Error occurred while decoding image
FixSuggestion: Possibly due to an unsupported image format or a corrupted file. Please verify the integrity of the image file

30103:E_RESOURCE_IMAGE_FROM_USER_OR_DESIGNError

Description: Error from user actions or the network conditions
FixSuggestion: In most cases, the issue arises from a canceled image request or an unavailable network connection

30196:E_RESOURCE_IMAGE_FROM_NETWORK_OR_OTHERSError

Description: Network or other issues
FixSuggestion: Please investigate the corresponding image download workflow for potential issues

30199:E_RESOURCE_IMAGE_EXCEPTIONError

Description: Exception occurred while loading image
FixSuggestion: An unidentified exception occurred that cannot be attributed to a specific cause. Please investigate further based on the available details

302:EB_RESOURCE_FONT

30200:E_RESOURCE_FONTError

Description: Failed to process font resource

30201:E_RESOURCE_FONT_SRC_FORMAT_ERRORError

Description: Font src format error
FixSuggestion: Please check the font-face format

30202:E_RESOURCE_FONT_RESOURCE_LOAD_ERRORError

Description: Failed to load font resource
FixSuggestion: Please check whether font resource is available

30203:E_RESOURCE_FONT_BASE64_PARSING_ERRORError

Description: Failed to parse base64 resource
FixSuggestion: Please check whether the base64 resource is available

30204:E_RESOURCE_FONT_FILE_FORMAT_NOT_SUPPORTEDError

Description: Font file format is not supported
FixSuggestion: Please use a font file in ttf or otf format

30205:E_RESOURCE_FONT_REGISTER_FAILEDUndecided

Description: Failed to register font
FixSuggestion: If the font is displayed correctly, there is no need to deal with it

303:EB_RESOURCE_EXTERNAL_RESOURCE

30301:E_RESOURCE_EXTERNAL_RESOURCE_REQUEST_FAILEDError

Description: Lynx resource fetcher requests failed
FixSuggestion: Please check whether the url of the external resource is available

30302:E_RESOURCE_EXTERNAL_RESOURCE_LOCAL_RESOURCE_LOAD_FAILError

Description: Failed to load local resource
FixSuggestion: Please check whether the local external resource is available

304:EB_RESOURCE_I18N

30400:E_RESOURCE_I18NError

Description: i18n Resource Error

321:EB_RESOURCE_MODULE

32101:E_RESOURCE_MODULE_PARAMS_ERRORError

Description: Parameter type mismatch or incorrect number of parameters while calling the requestResourcePrefetch or cancelResourcePrefetch API
FixSuggestion: Please refer to the parameter descriptions of this API in documentation and check the parameters used in the call

32102:E_RESOURCE_MODULE_IMG_PREFETCH_HELPER_NOT_EXISTError

Description: Unable to access the image service because the app has not integrated LynxImageService
FixSuggestion: Please refer to the official documentation to integrate LynxImageService into your app

32103:E_RESOURCE_MODULE_RESOURCE_SERVICE_NOT_EXISTError

Description: Unable to access resources because the app has not integrated the resource service
FixSuggestion: Please refer to the official documentation to implement the ILynxResourceService and integrate it into your app

398:EB_RESOURCE_CUSTOM

39800:E_RESOURCE_CUSTOMError

Description: Unexpected custom error
FixSuggestion: This is unexpected. Please file an issue to Lynx to help address it

399:EB_RESOURCE_EXCEPTION

39900:E_RESOURCE_EXCEPTIONError

Description: Unexpect exception in loading resource
FixSuggestion: This is unexpected. Please file an issue to Lynx to help address it

401:EB_DATA_FLOW_UPDATE

40101:E_DATA_FLOW_UPDATE_INVALID_PROCESSORError

Description: Call built-in function as data processor
FixSuggestion: Should not call getDerivedStateFromProps, getDerivedStateFromError, shouldComponentUpdate as data processor

40102:E_DATA_FLOW_UPDATE_INVALID_TYPEError

Description: Invalid data type
FixSuggestion: Target string data should be enabled to be parsed into a table

40199:E_DATA_FLOW_UPDATE_EXCEPTIONError

Description: Exception occurred while updating data

501:EB_ELEMENT_API

50101:E_ELEMENT_API_FATALFatal

Description: Fatal error in element API. Please find detailed information in the context

50102:E_ELEMENT_API_ERRORError

Description: Error in element API. Please find detailed information in the context

502:EB_ELEMENT_UPDATE

50201:E_ELEMENT_UPDATE_NODE_IS_NULLFatal

Description: Element update error for an unspecified reason

601:EB_LAYOUT_INTERNAL

60100:E_LAYOUT_INTERNALError

Description: Cannot find ShadowNode
FixSuggestion: Lynx internal error. Please check whether the creating of corresponding ShadowNode failed

602:EB_LAYOUT_PERF

60201:E_LAYOUT_PERF_INFINITE_LOOPError

Description: Infinite Loop of layout is detected
FixSuggestion: Infinite loop of layout happens. It usually happens when the front-end decides the content size based on the viewport size, while the client is deciding the viewport size based on the content size

603:EB_LAYOUT_UPDATE

60301:E_LAYOUT_UPDATE_UI_NOT_FOUNDError

Description: Can not find UI while updating layout
FixSuggestion: This is an internal error of Lynx. LynxUI has not been created or the creation failed while updating

604:EB_LAYOUT_PLATFORM

60401:E_LAYOUT_PLATFORM_NODE_NULLError

Description: ShadowNode is accessed after destroyed
FixSuggestion: This is an internal error of Lynx, which usually occurs when multiple threads access ShadowNode at the same time

901:EB_NATIVE_MODULES_COMMON

90101:E_NATIVE_MODULES_COMMON_MODULE_NOT_FOUNDError

Description: Native module not found
FixSuggestion: Please verify that the invoked native module name matches the registered name and confirm module registration status

90102:E_NATIVE_MODULES_COMMON_FUNCTION_NOT_FOUNDError

Description: Native module method not found
FixSuggestion: Please verify proper method registration using platform-specific annotations on Android or static method declarations on iOS (For details, refer to the native module documentation). Additionally, ensure that the invoked method name exactly matches the registered name in the native module implementation

90103:E_NATIVE_MODULES_COMMON_WRONG_PARAM_NUMError

Description: Parameter count mismatch in native module method invocation
FixSuggestion: Please ensure that the number of parameters passed to the native method exactly matches the declared parameters in the native module implementation

90104:E_NATIVE_MODULES_COMMON_WRONG_PARAM_TYPEError

Description: Parameter type mismatch in native module method invocation
FixSuggestion: Please verify that the parameter types in the method call exactly match the native module implementation. Ensure type compatibility across all parameters and validate the parameter order corresponds to the native method signature. You can check the native module documentation for expected data types

90105:E_NATIVE_MODULES_COMMON_AUTHORIZATION_ERRORError

Description: Does not have permission to call the method
FixSuggestion: Please file an issue to Lynx to help address it

90106:E_NATIVE_MODULES_COMMON_SYSTEM_AUTHORIZATION_ERRORError

Description: Does not have permission to call the method
FixSuggestion: Please file an issue to Lynx to help address it

90107:E_NATIVE_MODULES_COMMON_RETURN_ERRORError

Description: The value returned by module method is invalid
FixSuggestion: Please file an issue to Lynx to help address it

998:EB_NATIVE_MODULES_CUSTOM_ERROR

99800:E_NATIVE_MODULES_CUSTOM_ERRORError

Description: Custom error reported from native module
FixSuggestion: This error is explicitly defined by the native module implementation. Please refer to the module error handling guide or contact the module maintainer with complete error context

999:EB_NATIVE_MODULES_EXCEPTION

99900:E_NATIVE_MODULES_EXCEPTIONError

Description: Internal exception in native module method execution
FixSuggestion: This error indicates an unhandled runtime exception within the native module implementation. Please refer to the module error handling guide or contact the module maintainer with complete error context

1099:EB_EVENT_EXCEPTION

109900:E_EVENT_EXCEPTIONError

Description: An exception occurred during LynxView dispatchTouchEvent
FixSuggestion: This error is caught by the Lynx Engine. Please file an issue to Lynx to help address it

1101:EB_MTS_RUNTIME_ERROR

110100:E_MTS_RUNTIME_ERRORUndecided

Description: Main thread script error for an unspecified reason

1111:EB_MTS_RENDERER_FUNCTION

111101:E_MTS_RENDERER_FUNCTION_FATALFatal

Description: Fatal error during rendering. Please find detailed information in the context

111102:E_MTS_RENDERER_FUNCTION_ERRORError

Description: Fatal error during rendering. Please find detailed information in the context

1202:EB_THREAD_WRONG_THREAD

120201:E_THREAD_WRONG_THREAD_DESTROY_ERRORError

Description: Please ensure that destroy is called on UI thread

120202:E_THREAD_WRONG_THREAD_SYNC_FLUSH_ERRORError

Description: Please ensure that SyncFlush is called on UI thread

1301:EB_CSS

130100:E_CSSUndecided

Description: CSS error for an unspecified reason

130101:E_CSS_UNKNOWN_PROPERTYUndecided

Description: Unknown CSS property id

130102:E_CSS_UNSUPPORTED_VALUEUndecided

Description: Unsupported CSS value
FixSuggestion: Please check your value for the property follow the detailed message

1302:EB_CSS_COMPUTED_CSS_VALUE

130201:E_CSS_COMPUTED_CSS_VALUE_UNKNOWN_SETTERError

Description: Error occurred while setting value to ComputedCSSValue
FixSuggestion: Ignore it or raise an issue on github to let us know. This error is unexpected, which might be caused by internal pipeline fault

130202:E_CSS_COMPUTED_CSS_VALUE_UNKNOWN_GETTERError

Description: Error occurred while getting value from ComputedCSSValue
FixSuggestion: Ignore it or raise an issue on github to let us know. This error is unexpected, which might be caused by internal pipeline fault

130203:E_CSS_COMPUTED_CSS_VALUE_UNSUPPORTED_INHERITANCEError

Description: Property is not inheritable
FixSuggestion: Remove property name from inheritance list

1303:EB_CSS_PARSER

130300:E_CSS_PARSERError

Description: Generic error while parsing CSS value. Value is not acceptable for the property
FixSuggestion: Please use values following the property definitions. You can get the definitions at the official website

1601:EB_LAZY_BUNDLE_LOAD

160101:E_LAZY_BUNDLE_LOAD_BAD_RESPONSEError

Description: Lazy bundle request returned with bad response
FixSuggestion: Please check whether the url of the lazy bundle is available

160102:E_LAZY_BUNDLE_LOAD_EMPTY_FILEError

Description: The binary data of lazy bundle is empty
FixSuggestion: Please check whether the lazy bundle file is empty

160103:E_LAZY_BUNDLE_LOAD_DECODE_FAILEDError

Description: Failed to decode lazy bundle binary data
FixSuggestion: Please check whether the lazy bundle file is broken or it is compatible with the host page

160104:E_LAZY_BUNDLE_LOAD_BAD_BUNDLEError

Description: A bad lazy bundle is provided
FixSuggestion: Please check the error message of the bundle

1901:EB_WORKLET_MTS_CALL_EXCEPTION

190100:E_WORKLET_MTS_CALL_EXCEPTIONError

Description: Please check the worklet function is callable, and the worklet file is imported correctly

1902:EB_WORKLET_RAF_CALL_EXCEPTION

190200:E_WORKLET_RAF_CALL_EXCEPTIONError

Description: Error for calling requestAnimationFrame
FixSuggestion: Calling requestAnimationFrame failed. This is usually caused by an error in the callback function. Please ensure that the callback function executes without errors

1903:EB_WORKLET_MODULE_EXCEPTION

190300:E_WORKLET_MODULE_EXCEPTIONError

Description: Can not find worklet module
FixSuggestion: Make sure you have imported worklet file correctly

2001:EB_MTS_BRIDGE_MODULE

200101:E_MTS_BRIDGE_MODULE_WRONG_PARAMError

Description: Invoke function with wrong parameter

2201:EB_COMPONENT_API

220101:E_COMPONENT_API_DEPRECATEDError

Description: A deprecated component API is invoked

2202:EB_COMPONENT_LIST

220201:E_COMPONENT_LIST_ILLEGAL_ITEM_KEYError

Description: Error for illegal list item-key
FixSuggestion: Please check the legality of the item-key

220202:E_COMPONENT_LIST_DUPLICATED_CELLError

Description: List has duplicated cell in cache
FixSuggestion: We have encountered a system-level error. Please file an issue to Lynx to help resolve this problem

220203:E_COMPONENT_LIST_CELL_NOT_FOUNDError

Description: List cell not found in cache
FixSuggestion: We have encountered a system-level error. Please file an issue to Lynx to help resolve this problem

220204:E_COMPONENT_LIST_DYNAMIC_CHANGE_ORIENTATIONError

Description: List does not support changing orientation dynamically
FixSuggestion: Please do not change the value of vertical-orientation dynamically

220205:E_COMPONENT_LIST_INVALID_PROPS_ARGError

Description: There is an invalid parameter set in some props
FixSuggestion: For parameter usage, please check documentation of list component

220206:E_COMPONENT_LIST_CHILD_COMPONENT_NOT_EXISTError

Description: Child component of list does not exist
FixSuggestion: The internal state of the engine has become inconsistent. Please file an issue to Lynx for help resolving this problem

220207:E_COMPONENT_LIST_UNSUPPORTED_THREAD_STRATEGYError

Description: Multi thread strategy can not be used by default
FixSuggestion: Please set the attribute enable-async-list of to true

220208:E_COMPONENT_LIST_DUPLICATE_ITEM_KEYError

Description: Error for duplicate list item-key
FixSuggestion: Please check the legality of the item-key

2203:EB_COMPONENT_IMAGE

220301:E_COMPONENT_IMAGE_UNSUPPORTED_PROPError

Description: Failed to apply blur-radius on <image> element, meaning that the effect will not be visible on this platform
FixSuggestion: This may be due to platform-specific limitations or system restrictions. If blur-radius is not supported on this platform, consider using CSS filter: blur() as an alternative

2298:EB_COMPONENT_CUSTOM

229800:E_COMPONENT_CUSTOMError

Description: An error occurs in an customized element

9901:EB_EXCEPTION_PLATFORM

990100:E_EXCEPTION_PLATFORMError

Description: Platform exceptions for an unspecified reason
FixSuggestion: This error is caught by Lynx engine. Please file an issue to Lynx for help

9902:EB_EXCEPTION_JNI

990200:E_EXCEPTION_JNIError

Description: JNI exceptions for an unspecified reason
FixSuggestion: This error is caught by Lynx engine. Please file an issue to Lynx for help

Except as otherwise noted, this work is licensed under a Creative Commons Attribution 4.0 International License, and code samples are licensed under the Apache License 2.0.