1# Webview错误码 2<!--Kit: ArkWeb--> 3<!--Subsystem: Web--> 4<!--Owner: @yp99ustc; @aohui; @zourongchun--> 5<!--Designer: @LongLie; @yaomingliu; @zhufenghao--> 6<!--Tester: @ghiker--> 7<!--Adviser: @HelloCrease--> 8 9> **说明：** 10> 11> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 12 13## 17100001 WebviewController没有和具体的Web组件关联 14 15**错误信息** 16 17Init error. The WebviewController must be associated with a Web component. 18 19**错误描述** 20 21WebviewController还没有和具体的Web组件关联，无法进行相应的操作。 22 23**处理步骤** 24 25请检查WebviewController对象是否已与Web组件关联，可以通过[onControllerAttached()](./arkts-basic-components-web-events.md#oncontrollerattached10)接口进行检查。 26 27 28## 17100002 Url格式错误 29 30**错误信息** 31 32URL error. Possible causes: 1. No valid cookie found for the specified URL. 2. The webpage corresponding to the URL is invalid, or the URL length exceeds 2048. 33 34**错误描述** 35 36URL错误，可能原因： 37 381. 未找到指定URL的有效Cookie。 39 402. 该URL对应的网页无效，或URL长度超过2048。 41 42**处理步骤** 43 44请检查输入的url是否正确且url长度不超过2048。 45 46 47## 17100003 resource路径错误 48 49**错误信息** 50 51Invalid resource path or file type. 52 53**错误描述** 54 55resource路径错误。 56 57**可能原因** 58 59资源路径下文件不存在或无法访问。 60 61**处理步骤** 62 63请检查输入的resource路径是否正确。 64 65 66## 17100004 功能开关未打开 67 68**错误信息** 69 70Function not enabled. 71 72**错误描述** 73 74功能开关未打开。 75 76**处理步骤** 77 78请检查相关功能开关是否已配置打开，如该功能对应的XXXAccess是否配置为true。 79 80 81## 17100005 cookie value格式错误 82 83**错误信息** 84 85The provided cookie value is invalid. It must follow the format specified in RFC 6265. 86 87**错误描述** 88 89cookie value格式错误。 90 91**可能原因** 92 93不支持的cookie value类型。 94 95**处理步骤** 96 97请检查输入的value是否正确。 98 99 100## 17100006 无法注册message port回调 101 102**错误信息** 103 104Failed to register a message event for the port. 105 106**错误描述** 107 108无法注册message port回调。 109 110**可能原因** 111 112port可能已经关闭。 113 114**处理步骤** 115 116请检查port是否关闭。 117 118 119## 17100008 删除不存在的javaScriptProxy 120 121**错误信息** 122 123Failed to delete JavaScriptProxy because it does not exist. 124 125**错误描述** 126 127删除不存在的javaScriptProxy。 128 129**可能原因** 130 131传入的javaScriptProxy之前没有注册。 132 133**处理步骤** 134 135检查传入的javaScriptProxy是否注册成功。 136 137 138## 17100010 无法使用该端口发送消息 139 140**错误信息** 141 142Failed to post messages through the port. 143 144**错误描述** 145 146无法使用该端口发送消息。 147 148**可能原因** 149 150该端口已关闭，或者对端端口已关闭。 151 152**处理步骤** 153 1541. 请确认本端端口是否调用了close接口。 155 1562. 请确认本端是否设置了port的onMessageEvent回调。 157 158 159## 17100011 输入参数origin错误 160 161**错误信息** 162 163Invalid origin.The origin format must follow defined in RFC 6454. 164 165**错误描述** 166 167输入参数origin错误。origin格式必须遵循RFC 6454中定义的格式。 168 169**可能原因** 170 1711. 参数origin为空。 172 1732. 参数origin不合法。 174 175**处理步骤** 176 177检查输入的参数。 178 179 180## 17100012 无可获取的webstorage源 181 182**错误信息** 183 184Invalid web storage origin. 185 186**错误描述** 187 188无可获取的webstorage源。 189 190**可能原因** 191 192没有使用相关的JS数据库API。 193 194**处理步骤** 195 1961. 检查是否有使用JS数据库API。 197 1982. 如果已经使用，检查调用失败原因，如databaseAccess开关是否打开。 199 200 201## 17100013 预连接时，输入socket数目无效 202 203**错误信息** 204 205The number of sockets to be preconnected is invalid. 206 207**错误描述** 208 209预连接时，输入socket的数目是无效的。 210 211**可能原因** 212 213预连接时，输入socket的数目小于等于0，或者大于6。 214 215**处理步骤** 216 217检查输入的socket的数目范围是否大于0且小于等于6。 218 219 220## 17100014 类型和值不匹配 221 222**错误信息** 223 224The type and value of the message do not match. 225 226**错误描述** 227 228消息的类型和值不匹配。 229 230**可能原因** 231 232获取消息的值和消息本身的类型不匹配。 233 234**处理步骤** 235 236需要根据消息的类型调用相应的接口来获取消息的值。举例：如获取到的类型是BOOLEAN，则需要调用GetBoolean接口来获取布尔值。 237 238 239## 17100016 下载任务没有处于暂停状态 240 241**错误信息** 242 243The download task is not paused. 244 245**错误描述** 246 247下载任务没有处于暂停状态。 248 249**可能原因** 250 251在下载没有暂停的情况下调用了WebDownloadItem.resume。 252 253**处理步骤** 254 255下载并没有被暂停，不需要恢复。 256 257 258## 17100018 没有设置一个委托类来接收下载状态 259 260**错误信息** 261 262No WebDownloadDelegate has been set yet. 263 264**错误描述** 265 266没有设置一个委托类来接收下载状态。 267 268**可能原因** 269 270没有设置委托类就调用了WebDownloadManager.resumeDownload。 271 272**处理步骤** 273 274先通过WebDownloadManager.setDownloadDelegate设置一个委托类。 275 276## 17100019 下载还没开始 277 278**错误信息** 279 280The download task is not started yet. 281 282**错误描述** 283 284下载任务还未开始。 285 286**可能原因** 287 288下载任务还没开始，此时调用pause/resume是无效的。 289 290**处理步骤** 291 292需要在WebDownloadDelegate.onBeforeDownload中调用start('xxx')并指定下载路径。 293 294## 17100020 注册自定义协议失败 295 296**错误信息** 297 298Failed to register custom schemes. 299 300**错误描述** 301 302注册自定义协议失败。 303 304**可能原因** 305 306在ArkWeb引擎初始化之后才设置自定义协议。 307 308**处理步骤** 309 310注册自定义协议需要在ArkWeb引擎初始化之前设置。 311 312## 17100021 WebResourceHandler已经失效 313 314**错误信息** 315 316The resource handler is invalid. 317 318**错误描述** 319 320WebResourceHandler已经失效。 321 322**可能原因** 323 3241.对应的请求在WebSchemeHandler中没有拦截； 325 3262.该请求拦截在构造返回体之前，因为某些原因已经请求结束； 327 3283.该WebResourceHandler已经调用过didFinish和didFail。 329 330 331**处理步骤** 332 333请勿在以上所说的情况下调用WebResourceHandler的接口。 334 335## 17100022 WebHttpBodyStream初始化失败 336 337**错误信息** 338 339Failed to initialize the HTTP body stream. 340 341**错误描述** 342 343WebHttpBodyStream数据初始化失败。 344 345**可能原因** 346 347发起的POST等类型的请求中，携带的数据不合法。例如里面数据流中有文件类型的数据，但是该文件路径不存在，则数据流初始化失败。 348 349**处理步骤** 350 351检查发起的POST等类型的请求中，携带的数据是否合法。 352 353## 17100023 使用了不被允许的端口号 354 355**错误信息** 356 357The port number is not within the allowed range. 358 359**错误描述** 360 361使用的端口号不在允许的取值范围内。 362 363**可能原因** 364 365由于部分端口号（例如小于1024的端口号）作为熟知或系统端口，在操作系统上需要特权才能开启，因此禁止应用使用这些端口号。 366 367**处理步骤** 368 369检查使用的端口号是否在允许的取值范围内。 370 371## 17100101 使用了错误的网络错误码 372 373**错误信息** 374 375The errorCode is either ARKWEB_NET_OK or outside the range of error codes in WebNetErrorList. 376 377**错误描述** 378 379网络错误码为ARKWEB_NET_OK或者超出了WebNetErrorList中的错误码范围。 380 381**可能原因** 382 383使用的错误码不在[WebNetErrorList](arkts-apis-netErrorList.md#webneterrorlist)范围内，或者调用didFail接口时使用了NET_OK错误码。 384 385**处理步骤** 386 387检查使用的错误码是否在[WebNetErrorList](arkts-apis-netErrorList.md#webneterrorlist)范围内，或者调用difFail时是否使用了NET_OK错误码。 388