说明

以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)说明文档。

socket错误码映射关系：2301000 + [内核错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-kernel)。

socket server错误码映射关系：2303100 + [内核错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-kernel)。

## 2301001 操作不允许

**错误信息**

Operation not permitted.

**错误描述**

操作不允许。

**可能原因**

非法操作。

**处理步骤**

检查操作步骤。

## 2301002 文件不存在

**错误信息**

No such file or directory.

**错误描述**

文件不存在。

**可能原因**

文件不存在。

**处理步骤**

检查文件名或文件路径。

## 2301003 进程不存在

**错误信息**

No such process.

**错误描述**

进程不存在。

**可能原因**

进程不存在。

**处理步骤**

排查进程信息。

## 2301004 系统调用中断

**错误信息**

Interrupted system call.

**错误描述**

系统调用中断。

**可能原因**

系统调用中断。

**处理步骤**

排查系统调用。

**TCP/UDP 错误码说明：**

TCP/UDP Socket其余错误码映射形式为：2301000 + Linux系统内核错误码errno，关键信息请参考Linux系统内核错误码。

## 2300002 系统内部错误

PhonePC/2in1TabletTVWearable

**错误信息**

System internal error.

**错误描述**

系统内部错误。

**可能原因**

1.内存异常。

2.空指针。

**处理步骤**

1.检查内存空间是否充足，清理内存后重试。

2.系统异常，请稍后重试或重启设备。

## 2301206 SOCKS5连接代理服务器失败

PhonePC/2in1TabletTVWearable

**错误信息**

Socks5 failed to connect to the proxy server.

**错误描述**

SOCKS5客户端连接代理服务器失败。

**可能原因**

代理服务器地址有误。

**处理步骤**

排查代理服务器地址是否正确。

## 2301207 SOCKS5认证用户名或密码无效

PhonePC/2in1TabletTVWearable

**错误信息**

Socks5 username or password is invalid.

**错误描述**

SOCKS5使用用户名密码认证方式时，用户名或者密码无效。

**可能原因**

用户名密码有误。

**处理步骤**

排查用户名密码是否设置准确。

## 2301208 SOCKS5连接远程服务器失败

PhonePC/2in1TabletTVWearable

**错误信息**

Socks5 failed to connect to the remote server.

**错误描述**

SOCKS5代理连接远程服务器失败。

**可能原因**

远程服务器网络问题。

**处理步骤**

排查远程服务器网络状况。

## 2301209 SOCKS5协商认证方式失败

PhonePC/2in1TabletTVWearable

**错误信息**

Socks5 failed to negotiate the authentication method.

**错误描述**

SOCKS5协商认证方式失败。

**可能原因**

代理服务器不支持客户端提供的认证方式。

**处理步骤**

排查代理服务器是否支持客户端提供的认证方式。

## 2301210 SOCKS5发送消息失败

PhonePC/2in1TabletTVWearable

**错误信息**

Socks5 failed to send the message.

**错误描述**

SOCKS5因系统调用错误，发送消息失败。

**可能原因**

内存溢出、参数无效等，关键信息请参考日志中Linux系统内核错误码。

**处理步骤**

尝试新建socket，再次发起连接。

## 2301211 SOCKS5接收消息失败

PhonePC/2in1TabletTVWearable

**错误信息**

Socks5 failed to receive the message.

**错误描述**

SOCKS5因系统调用错误，接收消息失败。

**可能原因**

内存溢出、参数无效等，关键信息请参考日志中Linux系统内核错误码。

**处理步骤**

尝试新建socket，再次发起连接。

## 2301212 SOCKS5消息序列化失败

PhonePC/2in1TabletTVWearable

**错误信息**

Socks5 serialization error.

**错误描述**

SOCKS5消息序列化失败。

**可能原因**

用户名密码过长，代理服务器、远端服务器地址和协议类型不匹配。

**处理步骤**

排查用户名密码长度是否过长，代理服务器、远端服务器的地址和协议类型是否匹配。

## 2301213 SOCKS5消息反序列化失败

PhonePC/2in1TabletTVWearable

**错误信息**

Socks5 deserialization error.

**错误描述**

SOCKS5消息反序列化失败。

**可能原因**

服务器响应数据包长度不符合协议。

**处理步骤**

排查服务器响应数据包。

## 2303104 中断系统调用

PhonePC/2in1TabletTVWearable

**错误信息**

Interrupted system call.

**错误描述**

中断系统调用。

**可能原因**

调用connect时，可能会导致阻塞时间过长，所以系统产生中断信号，返回EINTR错误。

**处理步骤**

尝试重新走网络连接流程。

## 2303109 错误文件编号

PhonePC/2in1TabletTVWearable

**错误信息**

Bad file number.

**错误描述**

在本地关闭的套接字上进行操作将返回该错误。

**可能原因**

socket fd可能被关闭了，所以发生参数无效的错误。

**处理步骤**

检查socket是否被意外关闭。

## 2303111 资源暂时不可用，请重试

PhonePC/2in1TabletTVWearable

**错误信息**

Resource temporarily unavailable. Try again.

**错误描述**

系统资源暂时不可用，尝试再次调用。

**可能原因**

系统资源繁忙。

**处理步骤**

重新调用接口。

## 2303188 非套接字的套接字操作

PhonePC/2in1TabletTVWearable

**错误信息**

Not a socket.

**错误描述**

参数socket未指定一个套接字描述符。

**可能原因**

参数不是套接字类型的描述符。

**处理步骤**

检查代码描述符的获取是否正确。

## 2303191 socket协议类型错误

PhonePC/2in1TabletTVWearable

**错误信息**

Incorrect socket protocol type.

**错误描述**

参数设置的协议类型错误。

**可能原因**

标识了协议的Socket函数在不支持的socket上进行操作，如Internet UDP协议不能被标识为SOCK\_STREAM socket类型。

**处理步骤**

检查参数设置是否符合协议类型。

## 2303198 网络地址已被使用

PhonePC/2in1TabletTVWearable

**错误信息**

Address already in use.

**错误描述**

地址已被使用。

**可能原因**

如果应用程序试图将套接字绑定到已用于现有套接字的IP地址/端口，或未正确关闭的套接字，或仍在关闭过程中的套接字，则会发生此错误。

**处理步骤**

尝试其他地址。

## 2303199 不能分配请求的地址

PhonePC/2in1TabletTVWearable

**错误信息**

Address not available.

**错误描述**

请求的地址在其上下文中无效。

**可能原因**

当远程地址或端口对远程计算机无效时，可能发生该问题。

**处理步骤**

检查地址或端口是否正确。

## 2303200 网络已关闭

**错误信息**

Network is down.

**错误描述**

网络已关闭。

**可能原因**

网络服务未启动或已停止。

**处理步骤**

检查网络连接。

## 2303210 连接超时

PhonePC/2in1TabletTVWearable

**错误信息**

Connection timed out.

**错误描述**

长时间不能和远程服务器建立连接。

**可能原因**

这种情况一般发生在服务器主机崩溃。

**处理步骤**

本地无法处理此问题，需确认远程服务器是否出现故障。

## 2303501 SSL为空

PhonePC/2in1TabletTVWearable

**错误信息**

SSL is null.

**错误描述**

参数错误。

**可能原因**

当[Tlssocket.connect](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-socket#connect9)未调用或者[Tlssocket.connect](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-socket#connect9)执行未成功时发生该错误。

**处理步骤**

尝试重新执行一遍流程。

## 2303502 TLS读取错误

PhonePC/2in1TabletTVWearable

**错误信息**

An error occurred when reading data on the TLS socket.

**错误描述**

等待套接字可读。

**可能原因**

底层socket阻塞。

**处理步骤**

重新执行接收数据的操作。

## 2303503 TLS写入错误

PhonePC/2in1TabletTVWearable

**错误信息**

An error occurred when writing data on the TLS socket.

**错误描述**

等待套接字可写。

**可能原因**

发送端缓冲区已满时，底层套接字发送将给出EWOUDLBLOCK错误，这意味着服务器没有读取从客户端发送的消息。

**处理步骤**

需检查服务器状态并进行修复。

## 2303504 查找x509时出错

PhonePC/2in1TabletTVWearable

**错误信息**

An error occurred when verifying the x509 certificate.

**错误描述**

认证x509证书发生错误，操作未完成。

**可能原因**

本地证书和服务器证书不匹配。

**处理步骤**

检查本地CA根证书和服务器证书是否匹配。

## 2303505 TLS系统调用错误

PhonePC/2in1TabletTVWearable

**错误信息**

An error occurred in the TLS system call.

**错误描述**

发生了一些不可恢复的致命I/O错误。

**可能原因**

网络问题，导致通信失败。

**处理步骤**

请参阅Linux系统内核错误码errno以了解详细信息。

## 2303506 清除TLS连接出错

PhonePC/2in1TabletTVWearable

**错误信息**

Failed to close the TLS connection.

**错误描述**

TLS/SSL连接已关闭。

**可能原因**

协议中出现关闭警报时，即连接已完全关闭时，才会返回此结果代码。

**处理步骤**

尝试重新发起连接。