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;
}
}
}