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