Error Codes
102: EB_APP_BUNDLE_LOAD
10201: E_APP_BUNDLE_LOAD_RENDER_FAILED Fatal
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_READY Fatal
Description: loadTemplate while LynxEnv has not been initialized
FixSuggestion: Please call the initialization method of LynxEnv before loadTemplate
10203: E_APP_BUNDLE_LOAD_BAD_RESPONSE Fatal
Description: Failed to fetch app bundle by provider FixSuggestion: Please check if the app bundle is available
10204: E_APP_BUNDLE_LOAD_PARSE_FAILED Fatal
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_BUNDLE Fatal
Description: A bad TemplateBundle is provided FixSuggestion: Please check the error message of the bundle
10299: E_APP_BUNDLE_LOAD_EXCEPTION Fatal
Description: Exception occurred while rendering app bundle
105: EB_APP_BUNDLE_RELOAD
10501: E_APP_BUNDLE_RELOAD_EARLY_RELOAD Error
Description: reloadTemplate before loadTemplate
FixSuggestion: Please loadTemplate before reloadTemplate
201: EB_BTS_RUNTIME_ERROR
20100: E_BTS_RUNTIME_ERROR Undecided
Description: Runtime error for an unspecified reason
20101: E_BTS_RUNTIME_ERROR_SCRIPT_ERROR Fatal
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_ERROR Fatal
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_ERROR Error
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_FREQUENCY Warn
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_IMAGE Error
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_SOURCE Error
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_DESIGN Error
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_OTHERS Error
Description: Network or other issues FixSuggestion: Please investigate the corresponding image download workflow for potential issues
30199: E_RESOURCE_IMAGE_EXCEPTION Error
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_FONT Error
Description: Failed to process font resource
30201: E_RESOURCE_FONT_SRC_FORMAT_ERROR Error
Description: Font src format error FixSuggestion: Please check the font-face format
30202: E_RESOURCE_FONT_RESOURCE_LOAD_ERROR Error
Description: Failed to load font resource FixSuggestion: Please check whether font resource is available
30203: E_RESOURCE_FONT_BASE64_PARSING_ERROR Error
Description: Failed to parse base64 resource FixSuggestion: Please check whether the base64 resource is available
30204: E_RESOURCE_FONT_FILE_FORMAT_NOT_SUPPORTED Error
Description: Font file format is not supported FixSuggestion: Please use a font file in ttf or otf format
30205: E_RESOURCE_FONT_REGISTER_FAILED Undecided
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_FAILED Error
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_FAIL Error
Description: Failed to load local resource FixSuggestion: Please check whether the local external resource is available
304: EB_RESOURCE_I18N
30400: E_RESOURCE_I18N Error
Description: i18n Resource Error
321: EB_RESOURCE_MODULE
32101: E_RESOURCE_MODULE_PARAMS_ERROR Error
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_EXIST Error
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_EXIST Error
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_CUSTOM Error
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_EXCEPTION Error
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_PROCESSOR Error
Description: Call built-in function as data processor
FixSuggestion: Should not call getDerivedStateFromProps, getDerivedStateFromError, shouldComponentUpdate as data processor
40102: E_DATA_FLOW_UPDATE_INVALID_TYPE Error
Description: Invalid data type FixSuggestion: Target string data should be enabled to be parsed into a table
40199: E_DATA_FLOW_UPDATE_EXCEPTION Error
Description: Exception occurred while updating data
501: EB_ELEMENT_API
50101: E_ELEMENT_API_FATAL Fatal
Description: Fatal error in element API. Please find detailed information in the context
50102: E_ELEMENT_API_ERROR Error
Description: Error in element API. Please find detailed information in the context
502: EB_ELEMENT_UPDATE
50201: E_ELEMENT_UPDATE_NODE_IS_NULL Fatal
Description: Element update error for an unspecified reason
601: EB_LAYOUT_INTERNAL
60100: E_LAYOUT_INTERNAL Error
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_LOOP Error
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_FOUND Error
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_NULL Error
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_FOUND Error
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_FOUND Error
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_NUM Error
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_TYPE Error
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_ERROR Error
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_ERROR Error
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_ERROR Error
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_ERROR Error
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_EXCEPTION Error
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_EXCEPTION Error
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_ERROR Undecided
Description: Main thread script error for an unspecified reason
1111: EB_MTS_RENDERER_FUNCTION
111101: E_MTS_RENDERER_FUNCTION_FATAL Fatal
Description: Fatal error during rendering. Please find detailed information in the context
111102: E_MTS_RENDERER_FUNCTION_ERROR Error
Description: Fatal error during rendering. Please find detailed information in the context
1202: EB_THREAD_WRONG_THREAD
120201: E_THREAD_WRONG_THREAD_DESTROY_ERROR Error
Description: Please ensure that destroy is called on UI thread
120202: E_THREAD_WRONG_THREAD_SYNC_FLUSH_ERROR Error
Description: Please ensure that SyncFlush is called on UI thread
1301: EB_CSS
130100: E_CSS Undecided
Description: CSS error for an unspecified reason
130101: E_CSS_UNKNOWN_PROPERTY Undecided
Description: Unknown CSS property id
130102: E_CSS_UNSUPPORTED_VALUE Undecided
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_SETTER Error
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_GETTER Error
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_INHERITANCE Error
Description: Property is not inheritable FixSuggestion: Remove property name from inheritance list
1303: EB_CSS_PARSER
130300: E_CSS_PARSER Error
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_RESPONSE Error
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_FILE Error
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_FAILED Error
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_BUNDLE Error
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_EXCEPTION Error
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_EXCEPTION Error
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_EXCEPTION Error
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_PARAM Error
Description: Invoke function with wrong parameter
2201: EB_COMPONENT_API
220101: E_COMPONENT_API_DEPRECATED Error
Description: A deprecated component API is invoked
2202: EB_COMPONENT_LIST
220201: E_COMPONENT_LIST_ILLEGAL_ITEM_KEY Error
Description: Error for illegal list item-key FixSuggestion: Please check the legality of the item-key
220202: E_COMPONENT_LIST_DUPLICATED_CELL Error
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_FOUND Error
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_ORIENTATION Error
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_ARG Error
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_EXIST Error
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_STRATEGY Error
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_KEY Error
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_PROP Error
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_CUSTOM Error
Description: An error occurs in an customized element
9901: EB_EXCEPTION_PLATFORM
990100: E_EXCEPTION_PLATFORM Error
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_JNI Error
Description: JNI exceptions for an unspecified reason FixSuggestion: This error is caught by Lynx engine. Please file an issue to Lynx for help