nexus
Core API

错误参考

错误边界以及常见的稳定 Nexus 错误代码。

Nexus 错误包含稳定的 code、错误消息,以及可用时的诊断字段 context 和 cause。 应使用安全接口推断出的错误联合类型进行类型收窄,不要统一断言为 Error。处理方式见错误和超时。

公共错误联合类型

类型边界
ConnectionAcquireErrorsafeConnect 和 safeConnectMulticast
ResourceAcquireErrorsafeGet 和连接集合中各成员的服务获取结果
NexusCallErrorNexus.safeCall 和带类型的调用失败处理器

这些类型是具体错误类型的联合,不是额外的异常包装。配置及其他运行时安全方法目前按签名返回 Result<..., Error>。

常见代码

Code含义 / 响应
E_USAGE_INVALIDAPI 使用或选项无效;修复输入
E_SERVICE_AMBIGUOUS被动获取单连接时匹配多个会话;需收窄条件
E_SERVICE_ACQUISITION_TIMEOUT获取连接的等待超时
E_ABORTED获取等待被中止
E_CONN_CLOSED绑定的会话已断开;需获取新句柄
E_SERVICE_UNAVAILABLE当前会话中没有该服务
E_AUTH_CONNECT_DENIED连接准入被拒绝
E_AUTH_CALL_DENIED请求的操作被拒绝
E_CALL_TIMEOUT本地调用等待过期;远程执行可能已发生
E_REMOTE_EXCEPTION远程业务代码抛出异常
E_PROVIDER_DUPLICATE_TOKEN提交注册的服务包含重复 Token ID

此表列出常见面向应用的代码,不是每种传输或协议变体。导出的具体 class 包括 NexusUsageError、NexusDisconnectedError、NexusServiceError、NexusResourceError、NexusRemoteError、NexusConnectionError、NexusConnectionConstraintFailedError、NexusProtocolIncompatibleError、NexusHandshakeError、NexusTransportError、NexusEndpointConnectError、NexusEndpointListenError、NexusEndpointCapabilityError 和 NexusProtocolError。

对端返回的框架错误保留原有分类。业务异常即使使用相同错误码,也不会被当作框架错误,而是报告为 NexusRemoteError,并保留序列化后的原始错误供诊断。

同一份 Core 包内可以使用 instanceof。处理序列化错误或存在多份包副本时,应优先使用 code。

在 GitHub 上编辑此页