1# UIExtension错误码 2<!--Kit: ArkUI--> 3<!--Subsystem: ArkUI--> 4<!--Owner: @dutie123--> 5<!--Designer: @lmleon--> 6<!--Tester: @fredyuan0912--> 7<!--Adviser: @ge-yafang--> 8 9> **说明：** 10> 11> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 12 13## 1011 Ability启动失败 14 15**错误信息** 16 17Failed to start the UIExtension ability. 18 19**错误描述** 20 21扩展Ability拉起失败，请检查扩展Ability的Want参数。 22 23**可能原因** 24 251. Want参数配置错误； 262. type类型不一致； 273. 提供方应用未安装； 28 29**处理步骤** 30 31检查Want参数配置、应用是否安装等。 32 33## 1012 Ability切后台失败 34 35**错误信息** 36 37Failed to switch the UIExtension ability to the background. 38 39**错误描述** 40 41扩展Ability切后台失败。 42 43**可能原因** 44 45扩展Ability切后台失败，需根据AMS日志具体分析。 46 47**处理步骤** 48 49根据AMS日志进行分析。 50 51## 1013 Ability终止失败 52 53**错误信息** 54 55Failed to destroy the UIExtension ability. 56 57**错误描述** 58 59扩展Ability终止失败。 60 61**可能原因** 62 63扩展Ability终止失败，需根据AMS日志具体分析。 64 65**处理步骤** 66 67根据AMS日志进行分析。 68 69## 100011 未注册同步回调 70 71**错误信息** 72 73No callback has been registered to respond to this request. 74 75**错误描述** 76 77扩展Ability未注册同步回调。 78 79**可能原因** 80 81组件使用方调用sendSync接口向被拉起的Ability发送数据前，扩展Ability未注册同步回调监听。 82 83**处理步骤** 84 851. 扩展Ability注册同步回调监听； 862. 组件使用方调用sendSync接口向被拉起的Ability发送数据。 87 88## 100012 数据发送失败 89 90**错误信息** 91 92Transferring data failed. 93 94**错误描述** 95 96数据发送失败。 97 98**可能原因** 99 100数据发送失败，需根据AMS日志具体分析。 101 102**处理步骤** 103 104根据AMS日志进行分析。 105 106## 100013 禁止嵌套 107 108**错误信息** 109 110Cascading UIExtension components is not allowed. 111 112**错误描述** 113 114拉取另一个嵌入式组件失败，UIExtension存在特殊场景嵌套。 115 116**可能原因** 117 118可能存在UIExtension组件间嵌套。 119 120**处理步骤** 121 122请确认UIExtension组件规格，避免特殊场景嵌套。 123 124## 100014 Ability退出异常 125 126**错误信息** 127 128The UIExtension ability exited unexpectedly. 129 130**错误描述** 131 132扩展Ability退出异常。 133 134**可能原因** 135 136扩展Ability退出异常，需根据AMS日志具体分析。 137 138**处理步骤** 139 140根据AMS日志进行分析。 141 142## 100015 生命周期超时 143 144**错误信息** 145 146The lifecycle of the UIExtension ability has timed out. 147 148**错误描述** 149 150扩展Ability生命周期超时。 151 152**可能原因** 153 154扩展Ability生命周期超时，需根据AMS日志具体分析。 155 156**处理步骤** 157 158根据AMS日志进行分析。 159 160## 100016 Key事件处理超时 161 162**错误信息** 163 164Key event processing by the UIExtension ability has timed out. 165 166**错误描述** 167 168扩展Ability处理Key事件超时。 169 170**可能原因** 171 172扩展Ability处理Key事件超时，需根据AMS日志具体分析。 173 174**处理步骤** 175 176根据AMS日志进行分析。 177 178## 100018 Ability启动失败 179 180**错误信息** 181 182Failed to start the UIExtension ability. 183 184**错误描述** 185 186设置onTerminated回调场景下，扩展Ability拉起失败，请检查扩展Ability的Want参数。 187 188**可能原因** 189 1901. Want参数配置错误； 1912. type类型不一致，具体请参考[EmbeddedComponent组件](arkui-ts/ts-container-embedded-component.md#接口)； 1923. 提供方应用未安装； 1934. 设备类型不支持； 194 195**处理步骤** 196 197检查Want参数配置、应用是否安装、当前能力是否支持此设备类型等。 198 199## 100019 Ability切后台失败 200 201**错误信息** 202 203Failed to switch the UIExtension ability to the background. 204 205**错误描述** 206 207设置onTerminated回调场景下，扩展Ability切后台失败。 208 209**可能原因** 210 211扩展Ability切后台失败，需根据AMS日志具体分析。 212 213**处理步骤** 214 215根据AMS日志进行分析。 216 217## 100020 Ability终止失败 218 219**错误信息** 220 221Failed to destroy the UIExtension ability. 222 223**错误描述** 224 225设置onTerminated回调场景下，扩展Ability终止失败。 226 227**可能原因** 228 229扩展Ability终止失败，需根据AMS日志具体分析。 230 231**处理步骤** 232 233根据AMS日志进行分析。 234 235## 100021 窗口透明检测 236 237**错误信息** 238 239Transparent node is detected in the UIExtension ability. 240 241**错误描述** 242 243扩展Ability存在透明节点。 244 245**可能原因** 246 247检测到扩展Ability存在透明节点，可能导致阻塞。 248 249**处理步骤** 250 251查杀透明节点，避免阻塞事件。