using System.Security.Authentication; using System.Text; namespace Common.Notify { /// /// 通知推送异常诊断工具 /// HttpClient 网络异常(尤其 SSL/TLS 握手失败)的真实根因藏在 InnerException 链里, /// 只记录外层 ex.Message 会得到"see inner exception"这类无用信息。 /// 本工具展开整条异常链并针对常见网络故障给出可读排查提示,供三个 Notifier 复用。 /// public static class NotifyError { /// /// 将异常展开为"外层 -> 内层 -> ..."的可读描述,并附加常见网络故障排查提示 /// public static string Describe(Exception? ex) { if (ex == null) return "未知错误"; var sb = new StringBuilder(); var current = ex; int depth = 0; // 最多展开 5 层,防止极端嵌套导致信息过长 while (current != null && depth < 5) { if (depth > 0) sb.Append(" -> "); sb.Append(current.Message); current = current.InnerException; depth++; } if (IsTimeout(ex)) { sb.Append("|排查:请求超时,请确认目标地址可达、Webhook 域名解析正常、无防火墙拦截出站 443"); } else if (IsSslFailure(ex)) { sb.Append("|排查:SSL/TLS 握手失败,常见原因为 " + "①服务器无法访问外网(工控内网请改用\"跨网中转(Outbox)\"推送模式,由跳板机 AlertBridge 实际发送) " + "②企业代理/防火墙做 SSL 拦截且其根证书未被本机信任 " + "③系统时间不准导致证书校验失败 " + "④Webhook 地址主机名或端口有误(非标准 HTTPS 端口)"); } return sb.ToString(); } /// /// 是否为超时(TaskCanceledException 且非用户主动取消,或 TimeoutException) /// private static bool IsTimeout(Exception ex) { for (var c = ex; c != null; c = c.InnerException) { if (c is TimeoutException) return true; // HttpClient 超时表现为 TaskCanceledException,内部通常带 TimeoutException if (c is TaskCanceledException && c.InnerException is TimeoutException) return true; } return false; } /// /// 是否为 SSL/TLS 握手或证书校验失败 /// private static bool IsSslFailure(Exception ex) { for (var c = ex; c != null; c = c.InnerException) { if (c is AuthenticationException) return true; var msg = c.Message; if (!string.IsNullOrEmpty(msg) && (msg.Contains("SSL", StringComparison.OrdinalIgnoreCase) || msg.Contains("TLS", StringComparison.OrdinalIgnoreCase) || msg.Contains("certificate", StringComparison.OrdinalIgnoreCase))) { return true; } } return false; } } }