1# HTTP错误码 2 3<!--Kit: Network Kit--> 4<!--Subsystem: Communication--> 5<!--Owner: @wmyao_mm--> 6<!--Designer: @guo-min_net--> 7<!--Tester: @tongxilin--> 8<!--Adviser: @zhang_yixin13--> 9 10> **说明：** 11> 12> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码](../errorcode-universal.md)说明文档。 13 14## 2300001 不支持的协议 15 16**错误信息** 17 18Unsupported protocol. 19 20**错误描述** 21 22协议版本服务器不支持。 23 24**可能原因** 25 26传入的协议版本，服务器不支持。 27 28**处理步骤** 29 30请检查传入的协议版本是否合理，排查服务器实现。 31 32## 2300003 URL格式错误 33 34**错误信息** 35 36Invalid URL format or missing URL. 37 38**错误描述** 39 40URL格式错误。 41 42**可能原因** 43 44可能传入的url格式不正确。 45 46**处理步骤** 47 48检查传入的url格式是否正确。 49 50## 2300005 代理服务器域名解析失败 51 52**错误信息** 53 54Failed to resolve the proxy name. 55 56**错误描述** 57 58代理服务器的域名无法解析。 59 60**可能原因** 61 62服务器的URL不正确。 63 64**处理步骤** 65 66排查代理服务器的URL是否正确。 67 68## 2300006 域名解析失败 69 70**错误信息** 71 72Failed to resolve the host name. 73 74**错误描述** 75 76服务器的域名无法解析。 77 78**可能原因** 79 801.传入的服务器的URL不正确。 81 822.网络不通畅。 83 84**处理步骤** 85 861.请检查输入的服务器的URL是否合理。 87 882.请检查网络连接情况。 89 90## 2300007 无法连接到服务器 91 92**错误信息** 93 94Failed to connect to the server. 95 96**错误描述** 97 98服务器无法连接。 99 100**可能原因** 101 102可能传入的url格式不正确。 103 104**处理步骤** 105 106检查传入的url格式是否正确。 107 108## 2300008 服务器返回非法数据 109 110**错误信息** 111 112Invalid server response. 113 114**错误描述** 115 116服务器返回非法数据。 117 118**可能原因** 119 120服务器出错，返回了非HTTP格式的数据。 121 122**处理步骤** 123 124排查服务器实现。 125 126## 2300009 拒绝对远程资源的访问 127 128**错误信息** 129 130Access to the remote resource denied. 131 132**错误描述** 133 134拒绝对远程资源的访问。 135 136**可能原因** 137 138指定的内容被服务器拒绝访问。 139 140**处理步骤** 141 142排查请求内容。 143 144## 2300016 HTTP2帧层错误 145 146**错误信息** 147 148Error in the HTTP2 framing layer. 149 150**错误描述** 151 152HTTP2层级的错误。 153 154**可能原因** 155 156服务器不支持HTTP2。 157 158**处理步骤** 159 160抓包分析、排查服务器是否支持HTTP2。 161 162## 2300018 服务器返回数据不完整 163 164**错误信息** 165 166Transferred a partial file. 167 168**错误描述** 169 170服务器返回的数据不完整。 171 172**可能原因** 173 174可能与服务器实现有关。 175 176**处理步骤** 177 178排查服务器实现。 179 180## 2300023 向磁盘/应用程序写入接收数据失败 181 182**错误信息** 183 184Failed to write the received data to the disk or application. 185 186**错误描述** 187 188向磁盘/应用程序写入接收数据失败。 189 190**可能原因** 191 1921.应用没有写文件权限或待下载的文件超过5M。 193 1942.上一次请求数据未接受完毕便调用destroy销毁导致接收数据不完整。 195 196**处理步骤** 197 198排查应用权限及待下载的文件大小。 199 200## 2300025 上传失败 201 202**错误信息** 203 204Upload failed. 205 206**错误描述** 207 208上传失败。 209 210**可能原因** 211 212文件过大或者网络问题，对于FTP，服务器通常会拒绝STOR命令，错误缓冲区通常包含服务器的解释。 213 214**处理步骤** 215 216排查文件大小及网络状况。 217 218## 2300026 从文件/应用程序中打开/读取本地数据失败 219 220**错误信息** 221 222Failed to open or read local data from the file or application. 223 224**错误描述** 225 226从文件/应用程序中打开/读取本地数据失败。 227 228**可能原因** 229 230应用没有读文件权限。 231 232**处理步骤** 233 234排查应用权限。 235 236## 2300027 内存不足 237 238**错误信息** 239 240Out of memory. 241 242**错误描述** 243 244内存不足。 245 246**可能原因** 247 248内存不足。 249 250**处理步骤** 251 252排查系统内存。 253 254## 2300028 操作超时 255 256**错误信息** 257 258Operation timeout. 259 260**错误描述** 261 262操作超时。 263 264**可能原因** 265 266TCP连接超时或读写超时。 267 268**处理步骤** 269 270排查网络或服务器问题，例如网络是否稳定、信号强度是否较弱、服务器负载是否过高、处理速度是否正常等。 271 272## 2300047 重定向次数达到最大值 273 274**错误信息** 275 276The number of redirections reaches the maximum allowed. 277 278**错误描述** 279 280重定向次数达到最大值。 281 282**可能原因** 283 284重定向次数过多。 285 286**处理步骤** 287 288排查服务器实现。 289 290## 2300052 服务器没有返回内容 291 292**错误信息** 293 294The server returned nothing (no header or data). 295 296**错误描述** 297 298服务器没有返回内容。 299 300**可能原因** 301 302可能与服务器实现有关。 303 304**处理步骤** 305 306排查服务器实现。 307 308## 2300055 发送网络数据失败 309 310**错误信息** 311 312Failed to send data to the peer. 313 314**错误描述** 315 316无法往对端发送数据，发送网络数据失败。 317 318**可能原因** 319 320网络问题。 321 322**处理步骤** 323 324排查网络。 325 326## 2300056 接收网络数据失败 327 328**错误信息** 329 330Failed to receive data from the peer. 331 332**错误描述** 333 334无法从对端收到数据，接收网络数据失败。 335 336**可能原因** 337 338网络问题。 339 340**处理步骤** 341 342排查网络问题。 343 344## 2300058 本地SSL证书错误 345 346**错误信息** 347 348Local SSL certificate error. 349 350**错误描述** 351 352本地SSL证书错误。 353 354**可能原因** 355 356SSL证书格式有错误。 357 358**处理步骤** 359 360检查SSL证书格式。 361 362## 2300059 无法使用指定的密码 363 364**错误信息** 365 366The specified SSL cipher cannot be used. 367 368**错误描述** 369 370无法使用指定的密码。 371 372**可能原因** 373 374client和server协商的加密算法系统不支持。 375 376**处理步骤** 377 378抓包分析协商的算法。 379 380## 2300060 远程服务器SSL证书或SSH密钥不正确 381 382**错误信息** 383 384Invalid SSL peer certificate or SSH remote key. 385 386**错误描述** 387 388远程服务器SSL证书或SSH密钥不正确。 389 390**可能原因** 391 392无法校验服务器身份，有可能是证书过期了。 393 394**处理步骤** 395 396检查证书有效性。 397 398## 2300061 无法识别或错误的HTTP编码格式 399 400**错误信息** 401 402Invalid HTTP encoding format. 403 404**错误描述** 405 406无法识别或错误的HTTP编码格式。 407 408**可能原因** 409 410HTTP编码格式不正确。 411 412**处理步骤** 413 414排查服务器实现。目前仅支持gzip编码。 415 416## 2300063 超出最大文件大小 417 418**错误信息** 419 420Maximum file size exceeded. 421 422**错误描述** 423 424超出最大文件大小。 425 426**可能原因** 427 428下载的文件过大。 429 430**处理步骤** 431 432排查服务器实现。 433 434## 2300070 服务器磁盘空间不足 435 436**错误信息** 437 438Remote disk full. 439 440**错误描述** 441 442服务器磁盘空间不足。 443 444**可能原因** 445 446服务器磁盘已满。 447 448**处理步骤** 449 450检查服务器磁盘空间。 451 452## 2300073 服务器返回文件已存在 453 454**错误信息** 455 456Remote file already exists. 457 458**错误描述** 459 460服务器返回文件已存在。 461 462**可能原因** 463 464上传文件的时候，服务器返回文件已经存在。 465 466**处理步骤** 467 468排查服务器。 469 470## 2300077 SSL CA证书不存在或没有访问权限 471 472**错误信息** 473 474The SSL CA certificate does not exist or is inaccessible. 475 476**错误描述** 477 478SSL CA证书不存在或没有访问权限。 479 480**可能原因** 481 482证书不存在或者没有访问权限。 483 484**处理步骤** 485 486检查证书是否存在或者有没有访问权限。 487 488## 2300078 URL请求的文件不存在 489 490**错误信息** 491 492Remote file not found. 493 494**错误描述** 495 496URL请求的文件不存在。 497 498**可能原因** 499 500URL请求的文件不存在。 501 502**处理步骤** 503 504检查URL请求的文件是否存在。 505 506## 2300094 身份校验失败 507 508**错误信息** 509 510Authentication error. 511 512**错误描述** 513 514身份校验失败。 515 516**可能原因** 517 518传入的校验身份的字段与服务器不匹配。 519 520**处理步骤** 521 522排查传入的校验身份的字段是否与服务器匹配。 523 524## 2300997 明文HTTP被拦截 525 526**错误信息** 527 528Cleartext traffic not permitted. 529 530**错误描述** 531 532明文HTTP被拦截，不允许访问。 533 534**可能原因** 535 536应用配置network_config.json文件中设置为明文不允许。 537 538**处理步骤** 539 540排查network_config.json中cleartextTrafficPermitted字段配置。 541 542## 2300998 不允许访问域名 543 544**错误信息** 545 546It is not allowed to access this domain. 547 548**错误描述** 549 550不允许访问此域名。 551 552**可能原因** 553 554元服务应用未正确配置服务器域名。 555 556**处理步骤** 557 558可参考配置服务器域名文档完成服务器域名相关配置。 559 560## 2300999 内部错误 561 562**错误信息** 563 564Internal error. 565 566**错误描述** 567 568内部错误。 569 570**可能原因** 571 572未知错误。 573 574**处理步骤** 575 576未知错误。 577