我用的是 Guzzle 组件。
在做一个请求的时候,遇到了以下问题,根据提示就找到了 curl 相关的报错代码解释。应该是比较权威的 https://curl.haxx.se/libcurl/c/libcurl-errors.html
虽然是英文。但是可以直接使用谷歌翻译来查看
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中没有片段部分。