使用 FabricClient API 时常见的异常和错误

  • 项目

借助 FabricClient API，群集和应用程序管理员可以对 Service Fabric 应用程序、服务或群集执行管理任务。 例如，部署、升级和删除应用程序、检查群集的运行状况或测试服务。 应用程序开发人员和群集管理员可以使用 FabricClient API 来开发用于管理 Service Fabric 群集和应用程序的工具。

使用 FabricClient 可以执行许多不同类型的操作。 由于输入错误、运行时错误或暂时性基础结构问题，每种方法可能会引发异常或错误。 请参阅 API 参考文档，以查找特定的方法会引发哪些异常。 不过，某些异常可能会由多个不同的 FabricClient API 引发。 下表列出了 FabricClient API 引发的常见异常。

例外 引发时机
System.Fabric.FabricObjectClosedException FabricClient 对象处于关闭状态。 释放正在使用的 FabricClient 对象，并实例化新的 FabricClient 对象。
System.TimeoutException 操作超时。如果完成操作花费的时间超过 MaxOperationTimeout，将返回 OperationTimedOut。
System.UnauthorizedAccessException 对操作的访问权限检查失败。 返回了 E_ACCESSDENIED。
System.Fabric.FabricException 执行操作时发生运行时错误。 任何 FabricClient 方法都可能引发 FabricException，ErrorCode 属性将指示异常的确切原因。 FabricErrorCode 枚举中将定义错误代码。
System.Fabric.FabricTransientException 由于出现某种暂时性错误状态，操作失败。 例如，由于副本的仲裁暂时不可访问，某项操作可能会失败。 暂时性异常对应于可重试的失败操作。

可能在 FabricException 中返回的某些常见 FabricErrorCode 错误：

Error 天气条件
CommunicationError 通信错误导致操作失败，请重试操作。
InvalidCredentialType 凭据类型无效。
InvalidX509FindType X509FindType 无效。
InvalidX509StoreLocation X509 存储位置无效。
InvalidX509StoreName X509 存储名称无效。
InvalidX509Thumbprint X509 证书指纹字符串无效。
InvalidProtectionLevel 保护级别无效。
InvalidX509Store 无法打开 X509 证书存储。
InvalidSubjectName 使用者名称无效。
InvalidAllowedCommonNameList 公用名字符串列表的格式无效。 应为逗号分隔的列表。