curl 报错代码对应含义

我用的是 Guzzle 组件。
在做一个请求的时候,遇到了以下问题,根据提示就找到了 curl 相关的报错代码解释。应该是比较权威的 https://curl.haxx.se/libcurl/c/libcurl-errors.html

虽然是英文。但是可以直接使用谷歌翻译来查看

curl 报错代码对应含义_第1张图片
image.png

libcurl错误代码

名称

libcurl-errors - libcurl中的错误代码

描述

此手册页包含libcurl中的大多数(如果不是全部)可用错误代码。它们为什么会发生,也可能包括解决问题的方法。

CURLcode

几乎所有“简单”接口函数都返回CURLcode错误代码。无论如何,使用curl_easy_setopt选项CURLOPT_ERRORBUFFER是一个好主意,因为它将为您提供一个人类可读的错误字符串,可以提供有关错误原因的更多详细信息,而不仅仅是错误代码。可以调用curl_easy_strerror从给定的CURLcode编号中获取错误字符串。

CURLcode是以下之一:

CURLE_OK(0)

一切都很好。像往常一样继续。

CURLE_UNSUPPORTED_PROTOCOL(1)

您传递给libcurl的URL使用了此libcurl不支持的协议。支持可能是您没有使用的编译时选项,它可能是拼写错误的协议字符串,或者只是libcurl没有代码的协议。

CURLE_FAILED_INIT(2)

很早的初始化代码失败了。这可能是内部错误或问题,或者是在初始时无法完成某些基本操作的资源问题。

CURLE_URL_MALFORMAT(3)

URL格式不正确。

CURLE_NOT_BUILT_IN(4)

由于构建时决定,未在此libcurl中找到所请求的功能,协议或选项。这意味着在构建libcurl时未启用或显式禁用某个功能或选项,并且为了使其正常运行,您必须获得重建的libcurl。

CURLE_COULDNT_RESOLVE_PROXY(5)

无法解析代理。无法解析给定的代理主机。

CURLE_COULDNT_RESOLVE_HOST(6)

无法解析主机。给定的远程主机未解析。

CURLE_COULDNT_CONNECT(7)

无法连接()到主机或代理。

CURLE_FTP_WEIRD_SERVER_REPLY(8)

服务器发送的数据libcurl无法解析。此错误代码不仅用于FTP,而且自7.51.0起别名为CURLE_WEIRD_SERVER_REPLY。

CURLE_REMOTE_ACCESS_DENIED(9)

我们被拒绝访问URL中给出的资源。对于FTP,尝试更改到远程目录时会发生这种情况。

CURLE_FTP_ACCEPT_FAILED(10)

在使用活动FTP会话时等待服务器连接回来时,通过控制连接或类似方式发送错误代码。

CURLE_FTP_WEIRD_PASS_REPLY(11)

在将FTP密码发送到服务器之后,libcurl希望得到适当的回复。此错误代码表示返回了意外的代码。

CURLE_FTP_ACCEPT_TIMEOUT(12)

在等待服务器连接的活动FTP会话期间,CURLOPT_ACCEPTTIMEOUT_MS(或内部默认值)超时已到期。

CURLE_FTP_WEIRD_PASV_REPLY(13)

libcurl无法从服务器获得合理的结果作为对PASV或EPSV命令的响应。服务器存在缺陷。

CURLE_FTP_WEIRD_227_FORMAT(14)

FTP服务器返回227行作为对PASV命令的响应。如果libcurl无法解析该行,则返回此返回码。

CURLE_FTP_CANT_GET_HOST(15)

查找用于新连接的主机的内部故障。

CURLE_HTTP2(16)

在HTTP2框架层中检测到问题。这有些通用,可能是几个问题中的一个,请参阅错误缓冲区了解详细信息。

CURLE_FTP_COULDNT_SET_TYPE(17)

尝试将传输模式设置为二进制或ASCII时收到错误。

CURLE_PARTIAL_FILE(18)

文件传输比预期的更短或更长。当服务器首次报告预期的传输大小,然后传递与先前给定大小不匹配的数据时,会发生这种情况。

CURLE_FTP_COULDNT_RETR_FILE(19)

这可能是对'RETR'命令的奇怪回复,也可能是零字节传输完成。

CURLE_QUOTE_ERROR(21)

向远程服务器发送自定义“QUOTE”命令时,其中一个命令返回的错误代码为400或更高(对于FTP)或以其他方式表示命令未成功完成。

CURLE_HTTP_RETURNED_ERROR(22)

如果CURLOPT_FAILONERROR设置为TRUE且HTTP服务器返回> = 400的错误代码,则返回此值。

CURLE_WRITE_ERROR(23)

将接收的数据写入本地文件时发生错误,或者从写回调将错误返回到libcurl。

CURLE_UPLOAD_FAILED(25)

启动上传失败。对于FTP,服务器通常拒绝STOR命令。错误缓冲区通常包含服务器对此的解释。

CURLE_READ_ERROR(26)

读取本地文件或读取回调返回的错误时出现问题。

CURLE_OUT_OF_MEMORY(27)

内存分配请求失败。这是严重的坏事,如果发生这种情况,事情就会严重搞乱。

CURLE_OPERATION_TIMEDOUT(28)

操作超时。根据条件达到规定的超时时间。

CURLE_FTP_PORT_FAILED(30)

FTP PORT命令返回错误。当您没有为libcurl指定足够好的地址时,这通常会发生。请参见CURLOPT_FTPPORT。

CURLE_FTP_COULDNT_USE_REST(31)

FTP REST命令返回错误。如果服务器是理智的,这应该永远不会发生。

CURLE_RANGE_ERROR(33)

服务器不支持或接受范围请求。

CURLE_HTTP_POST_ERROR(34)

这是一个奇怪的错误,主要是由于内部混乱造成的。

CURLE_SSL_CONNECT_ERROR(35)

SSL / TLS握手中出现问题。你真的想要错误缓冲区并在那里阅读消息,因为它会稍微查明问题。可以是证书(文件格式,路径,权限),密码等。

CURLE_BAD_DOWNLOAD_RESUME(36)

无法恢复下载,因为指定的偏移量超出了文件边界。

CURLE_FILE_COULDNT_READ_FILE(37)

无法打开以FILE://指定的文件。很可能是因为文件路径无法识别现有文件。你检查过文件权限了吗?

CURLE_LDAP_CANNOT_BIND(38)

LDAP无法绑定。LDAP绑定操作失败。

CURLE_LDAP_SEARCH_FAILED(39)

LDAP搜索失败。

CURLE_FUNCTION_NOT_FOUND(41)

找不到功能。找不到所需的zlib函数。

CURLE_ABORTED_BY_CALLBACK(42)

被回调中止。回调“abort”返回libcurl。

CURLE_BAD_FUNCTION_ARGUMENT(43)

内部错误。使用错误参数调用函数。

CURLE_INTERFACE_FAILED(45)

接口错误。无法使用指定的传出接口。使用CURLOPT_INTERFACE设置用于传出连接的源IP地址的接口。

CURLE_TOO_MANY_REDIRECTS(47)

重定向太多。在执行重定向后,libcurl会达到最大值。使用CURLOPT_MAXREDIRS设置限制。

CURLE_UNKNOWN_OPTION(48)

传递给libcurl的选项无法识别/已知。请参阅相应的文档。这很可能是使用libcurl的程序中的一个问题。错误缓冲区可能包含有关其所涉及的确切选项的更具体信息。

CURLE_TELNET_OPTION_SYNTAX(49)

telnet选项字符串是非法格式化的。

CURLE_GOT_NOTHING(52)

没有从服务器返回任何内容,在这种情况下,什么都没有被认为是错误。

CURLE_SSL_ENGINE_NOTFOUND(53)

找不到指定的加密引擎。

CURLE_SSL_ENGINE_SETFAILED(54)

将所选SSL加密引擎设置为默认值失败!

CURLE_SEND_ERROR(55)

发送网络数据失败。

CURLE_RECV_ERROR(56)

接收网络数据失败。

CURLE_SSL_CERTPROBLEM(58)

本地客户端证书的问题。

CURLE_SSL_CIPHER(59)

无法使用指定的密码。

CURLE_PEER_FAILED_VERIFICATION(60)

远程服务器的SSL证书或SSH md5指纹被认为不正常。自7.62.0起,此错误代码已与CURLE_SSL_CACERT统一。它之前的价值是51。

CURLE_BAD_CONTENT_ENCODING(61)

无法识别的传输编码。

CURLE_LDAP_INVALID_URL(62)

无效的LDAP URL。

CURLE_FILESIZE_EXCEEDED(63)

超出最大文件大小。

CURLE_USE_SSL_FAILED(64)

请求的FTP SSL级别失败。

CURLE_SEND_FAIL_REWIND(65)

在执行发送操作时,curl必须回滚数据以重新传输,但是倒带操作失败。

CURLE_SSL_ENGINE_INITFAILED(66)

启动SSL引擎失败。

CURLE_LOGIN_DENIED(67)

远程服务器拒绝curl登录(在7.13.1中添加)

CURLE_TFTP_NOTFOUND(68)

在TFTP服务器上找不到文件。

CURLE_TFTP_PERM(69)

TFTP服务器上的权限问题。

CURLE_REMOTE_DISK_FULL(70)

服务器上的磁盘空间不足。

CURLE_TFTP_ILLEGAL(71)

非法的TFTP操作。

CURLE_TFTP_UNKNOWNID(72)

未知的TFTP传输ID。

CURLE_REMOTE_FILE_EXISTS(73)

文件已存在且不会被覆盖。

CURLE_TFTP_NOSUCHUSER(74)

正常运行的TFTP服务器永远不应该返回此错误。

CURLE_CONV_FAILED(75)

字符转换失败。

CURLE_CONV_REQD(76)

呼叫者必须注册转换回调。

CURLE_SSL_CACERT_BADFILE(77)

读取SSL CA证书时出现问题(路径?访问权限?)

CURLE_REMOTE_FILE_NOT_FOUND(78)

URL中引用的资源不存在。

CURLE_SSH(79)

SSH会话期间发生了未指定的错误。

CURLE_SSL_SHUTDOWN_FAILED(80)

无法关闭SSL连接。

CURLE_AGAIN(81)

套接字尚未准备好发送/接收等待,直到它准备好再试一次。此返回码仅从curl_easy_recv和curl_easy_send返回(在7.18.2中添加)

CURLE_SSL_CRL_BADFILE(82)

无法加载CRL文件(在7.19.0中添加)

CURLE_SSL_ISSUER_ERROR(83)

发行人检查失败(在7.19.0中添加)

CURLE_FTP_PRET_FAILED(84)

FTP服务器根本不理解PRET命令或不支持给定的参数。使用CURLOPT_CUSTOMREQUEST时要小心,在PASV之前也会使用PRET CMD发送自定义LIST命令。(在7.20.0中添加)

CURLE_RTSP_CSEQ_ERROR(85)

RTSP CSeq号码不匹配。

CURLE_RTSP_SESSION_ERROR(86)

RTSP会话标识符不匹配。

CURLE_FTP_BAD_FILE_LIST(87)

无法解析FTP文件列表(在FTP通配符下载期间)。

CURLE_CHUNK_FAILED(88)

块回调报告错误。

CURLE_NO_CONNECTION_AVAILABLE(89)

(仅供内部使用,libcurl永远不会返回)没有可用的连接,会话将排队。(在7.30.0中添加)

CURLE_SSL_PINNEDPUBKEYNOTMATCH(90)

无法匹配CURLOPT_PINNEDPUBLICKEY指定的固定密钥。

CURLE_SSL_INVALIDCERTSTATUS(91)

当询问CURLOPT_SSL_VERIFYSTATUS时,状态返回失败。

CURLE_HTTP2_STREAM(92)

HTTP / 2成帧层中的流错误。

CURLE_RECURSIVE_API_CALL(93)

从回调内部调用API函数。

CURLE_OBSOLETE *

永远不会返回这些错误代码。它们在旧的libcurl版本中使用,目前尚未使用。

CURLMcode

这是libcurl多接口中函数使用的通用返回码。还要考虑curl_multi_strerror。

CURLM_CALL_MULTI_PERFORM(-1)

这不是一个真正的错误。这意味着您应该再次调用curl_multi_perform,而不要在其间执行select()或类似操作。在版本7.20.0之前,这可以通过curl_multi_perform返回,但在以后的版本中,此返回代码从不使用。

CURLM_OK(0)

事情很好。

CURLM_BAD_HANDLE(1)

传入的句柄不是有效的CURLM句柄。

CURLM_BAD_EASY_HANDLE(2)

容易处理不好/有效。这可能意味着它根本不是一个简单的手柄,或者可能是手柄已被这个或另一个多手柄使用。

CURLM_OUT_OF_MEMORY(3)

你注定要失败。

CURLM_INTERNAL_ERROR(4)

这只能在libcurl错误时返回。请向我们报告!

CURLM_BAD_SOCKET(5)

传入的套接字不是libcurl已经知道的有效套接字。(在7.15.4中添加)

CURLM_UNKNOWN_OPTION(6)

curl_multi_setopt()带有不支持的选项(在7.15.4中添加)

CURLM_ADDED_ALREADY(7)

已尝试添加到多手柄的简易手柄第二次添加。(在7.32.1中添加)

CURLM_RECURSIVE_API_CALL(8)

从回调内部调用API函数。

CURLSHcode

“share”接口将返回CURLSHcode以指示何时发生错误。还要考虑curl_share_strerror。

CURLSHE_OK(0)

一切都很好。像往常一样继续。

CURLSHE_BAD_OPTION(1)

传递给函数的选项无效。

CURLSHE_IN_USE(2)

共享对象当前正在使用中。

CURLSHE_INVALID(3)

无效的共享对象已传递给该函数。

CURLSHE_NOMEM(4)

没有足够的内存可用。(在7.12.0中添加)

CURLSHE_NOT_BUILT_IN(5)

无法执行请求的共享,因为您使用的库未启用该特定功能。(在7.23.0中添加)

CURLUcode

CURLUE_BAD_HANDLE(1)

应该是CURLU指针的参数作为NULL传入。

CURLUE_BAD_PARTPOINTER(2)

NULL指针被传递给curl_url_get的'part'参数。

CURLUE_MALFORMED_INPUT(3)

格式错误的输入传递给URL API函数。

CURLUE_BAD_PORT_NUMBER(4)

端口号不是0到65535之间的十进制数。

CURLUE_UNSUPPORTED_SCHEME(5)

此libcurl构建不支持给定的URL方案。

CURLUE_URLDECODE(6)

URL解码错误,很可能是因为输入中有垃圾。

CURLUE_OUT_OF_MEMORY(7)

记忆功能失败。

CURLUE_USER_NOT_ALLOWED(8)

禁止时,凭据在URL中传递。

CURLUE_UNKNOWN_PART(9)

未知的部件ID已传递给URL API函数。

CURLUE_NO_SCHEME(10)

URL中没有方案部分。

CURLUE_NO_USER(11)

URL中没有用户部分。

CURLUE_NO_PASSWORD(12)

URL中没有密码部分。

CURLUE_NO_OPTIONS(13)

URL中没有选项部分。

CURLUE_NO_HOST(14)

URL中没有主机部分。

CURLUE_NO_PORT(15)

URL中没有端口部分。

CURLUE_NO_QUERY(16)

URL中没有查询部分。

CURLUE_NO_FRAGMENT(17)

URL中没有片段部分。

也可以看看

你可能感兴趣的:(curl 报错代码对应含义)