SSE连接建立失败时会静默停留在readyState===0，需主动超时检测并分层处理：创建后5秒内未变为1则判定失败，结合网络状态、HTTP状态码等差异化提示，并前置fetch预检、避免重复初始化。

SSE 连接建立失败时，不会触发 onerror，也不会进入重试流程，而是静默停留在 readyState === 0。这种“无声失败”最容易被忽略，必须主动检测、分层判断、及时干预。

连接建立失败的典型表现

• 创建 EventSource 后，readyState 长期为 0（CONNECTING）
• 控制台无 onopen 日志，也无 onerror 输出
• Network 面板可见请求卡在 pending，或返回 401/403/502/CORS 错误，但前端收不到状态码

主动检测连接是否真正建立

不要依赖 onerror，而要在实例创建后立即启动超时监控：

• 创建 EventSource 后，启动一个 5 秒定时器
• 若期间 readyState 未变为 1（OPEN），即判定为初始连接失败
• 此时手动执行错误处理，例如清理实例、提示用户、终止后续逻辑

function waitForOpen(es, timeout = 5000) {
  return new Promise((resolve, reject) => {
    const timer = setTimeout(() => {
      if (es.readyState !== 1) {
        es.close();
        reject(new Error('SSE initial connection timeout'));
      }
    }, timeout);

    const check = () => {
      if (es.readyState === 1) {
        clearTimeout(timer);
        resolve();
      }
    };

    es.addEventListener('open', check, { once: true });
  });
}

分层识别失败原因并差异化提示

不同失败原因对应不同用户反馈和处理策略：

• navigator.onLine === false → 提示“⚠️ 当前无网络，请检查 Wi-Fi 或移动数据”
• fetch 预检返回 401/403 → 引导“? 登录已过期，请重新登录”
• fetch 预检返回 5xx → 显示“❌ 服务器暂时不可用，请稍后再试”
• 超时且 readyState === 0 → 提示“⚠️ 无法连接到实时服务，请确认地址是否正确”

✅ 推荐前置 fetch 预检：对需鉴权的 SSE 地址，先发轻量请求校验 token 和权限，避免直接建连失败后才暴露问题。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

立即学习“Java免费学习笔记（深入）”；

避免重复初始化与内存泄漏

每次新建前务必关闭旧实例，并清空引用：

• 调用 eventSource?.close()
• 将变量置为 null 或 undefined
• 在组件卸载（如 React 的 useEffect cleanup、Vue 的 onBeforeUnmount）中强制关闭
• 使用闭包或 WeakMap 管理当前实例，防止全局变量残留

不复杂但容易忽略