termchat: 断线自动重连 — 服务端常驻监听 + 客户端退避重连
- 服务端不再在接受首个连接后关闭 listener,新连接到来时替换旧连接 (替换语义同时是半开连接的恢复路径) - 客户端断线后指数退避自动重连(500ms 起步、封顶 10s),连上即重置; 支持先于服务端启动;连接阶段 5s 超时防不可达地址卡 SYN 重传 - socket 代数计数:被替换/拆除的旧 socket 的迟到事件全部判废 - 修复潜伏 bug:readline 将 socket error 转发重抛,无 listener 直接 崩进程 —— 原先"连不上报错退出"实为崩溃 - ECONNRESET 过滤(正常断开不再显示吓人报错)、同文本错误去重 (无限重连不刷屏)、TCP keepalive 30s - Phase 新增 reconnecting;UI 适配重连状态显示 - smoke 测试重写为事件驱动 4 场景(基础收发/客户端先行/服务端替换/ 服务端重启+断线排队 flush) Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
+132
-17
@@ -10,7 +10,14 @@ export interface ChatMessage {
|
||||
ts: number;
|
||||
}
|
||||
|
||||
export type Phase = "waiting" | "connected" | "closed";
|
||||
/**
|
||||
* 会话阶段:
|
||||
* - waiting 服务端等待对方连入 / 客户端连接中(从未连上过的失败也停在这里)
|
||||
* - connected 已连接
|
||||
* - reconnecting 客户端连上过又断开,退避重连中(服务端不会进此状态)
|
||||
* - closed 终态(手动 close 或 listen 失败)
|
||||
*/
|
||||
export type Phase = "waiting" | "connected" | "reconnecting" | "closed";
|
||||
|
||||
export interface SessionHandlers {
|
||||
onMessage(m: ChatMessage): void;
|
||||
@@ -29,10 +36,18 @@ export interface Session {
|
||||
readonly phase: Phase;
|
||||
}
|
||||
|
||||
/** 客户端重连退避:500ms 起,指数增长,封顶 10s */
|
||||
const RETRY_BASE_MS = 500;
|
||||
const RETRY_MAX_MS = 10_000;
|
||||
/** 连接超时:超时就 destroy 重试,免得不可达地址上卡 ~21s 的 SYN 重传 */
|
||||
const CONNECT_TIMEOUT_MS = 5_000;
|
||||
/** TCP keepalive:半开连接的探测(主恢复路径是替换/重连,这只是让状态行别谎报) */
|
||||
const KEEPALIVE_MS = 30_000;
|
||||
|
||||
/**
|
||||
* 建立一条双人会话:
|
||||
* - server: 监听端口,等对方连入(只接受第一个连接)
|
||||
* - client: 主动连接对方
|
||||
* - server: 监听端口,常驻等待对方连入;新连接到来时替换旧连接(半开连接的恢复路径)
|
||||
* - client: 主动连接对方,断线后指数退避自动重连,可以先于服务端启动
|
||||
* 协议:每行一个 JSON
|
||||
*/
|
||||
export function createSession(
|
||||
@@ -42,8 +57,15 @@ export function createSession(
|
||||
): Session {
|
||||
let socket: net.Socket | null = null;
|
||||
let server: net.Server | null = null;
|
||||
let rl: ReturnType<typeof createInterface> | null = null;
|
||||
let phase: Phase = "waiting";
|
||||
const queue: string[] = [];
|
||||
let gen = 0; // socket 代数:被替换/拆除的旧 socket 的事件凭它判废
|
||||
let stopped = false; // 手动 close() 后一切活动停止
|
||||
let everConnected = false; // 是否连上过(首次/重连文案 + waiting/reconnecting 语义)
|
||||
let retryTimer: NodeJS.Timeout | null = null; // 单一重连定时器(单飞,防重复调度)
|
||||
let retryDelay = RETRY_BASE_MS;
|
||||
let lastErrText = ""; // 同文本错误只提示一次,防无限重连刷屏
|
||||
|
||||
const sys = (text: string): void =>
|
||||
handlers.onMessage({ type: "sys", name: "", text, ts: Date.now() });
|
||||
@@ -53,14 +75,33 @@ export function createSession(
|
||||
phase = p;
|
||||
handlers.onPhase(p);
|
||||
if (p === "connected") {
|
||||
everConnected = true;
|
||||
for (const payload of queue.splice(0)) socket?.write(payload);
|
||||
}
|
||||
};
|
||||
|
||||
const wire = (sock: net.Socket): void => {
|
||||
/** 拆除当前 socket(替换旧连接 / close() 用):先加代数,旧 socket 的事件必然过期 */
|
||||
const teardownSocket = (): void => {
|
||||
gen++;
|
||||
const s = socket;
|
||||
socket = null;
|
||||
const r = rl;
|
||||
rl = null;
|
||||
r?.close();
|
||||
s?.destroy();
|
||||
};
|
||||
|
||||
/** 挂上新 socket:事件回调凭代数 g 判废,过期即忽略 */
|
||||
const wire = (sock: net.Socket): number => {
|
||||
const g = ++gen;
|
||||
socket = sock;
|
||||
const rl = createInterface({ input: sock });
|
||||
sock.setKeepAlive(true, KEEPALIVE_MS);
|
||||
rl = createInterface({ input: sock });
|
||||
// readline 会把 socket 的 error 转发到 Interface 上再抛,没 listener 会崩整个进程
|
||||
// (socket 层已处理并去重提示,这里 no-op 即可)
|
||||
rl.on("error", () => {});
|
||||
rl.on("line", (line) => {
|
||||
if (g !== gen) return; // 迟到的旧 socket 数据,丢弃
|
||||
const s = line.trim();
|
||||
if (!s) return;
|
||||
try {
|
||||
@@ -70,31 +111,98 @@ export function createSession(
|
||||
handlers.onMessage({ type: "msg", name: "peer", text: s, ts: Date.now() });
|
||||
}
|
||||
});
|
||||
sock.on("error", (err) => sys(`Connection error: ${err.message}`));
|
||||
sock.on("close", () => setPhase("closed"));
|
||||
sock.on("error", (err) => {
|
||||
if (g !== gen) return;
|
||||
// ECONNRESET 是常态(旧连接被替换/对端被杀),交给 close 走正常断开路径
|
||||
if ((err as NodeJS.ErrnoException).code === "ECONNRESET") return;
|
||||
if (err.message !== lastErrText) {
|
||||
lastErrText = err.message;
|
||||
sys(`Connection failed: ${err.message}`);
|
||||
}
|
||||
});
|
||||
sock.on("close", () => {
|
||||
if (g !== gen) return; // 被替换/拆除的旧 socket
|
||||
if (socket === sock) {
|
||||
socket = null;
|
||||
rl?.close();
|
||||
rl = null;
|
||||
}
|
||||
if (stopped || phase === "closed") return;
|
||||
if (role === "server") {
|
||||
setPhase("waiting");
|
||||
sys("Peer disconnected, waiting for reconnect…");
|
||||
} else {
|
||||
// 从未连上过的失败停在 waiting(不算"重连");连上过才进 reconnecting
|
||||
if (everConnected) setPhase("reconnecting");
|
||||
scheduleRetry();
|
||||
}
|
||||
});
|
||||
return g;
|
||||
};
|
||||
|
||||
/** 安排一次重连:单飞 guard 收敛 error+close 连发、超时与 close 的竞态 */
|
||||
const scheduleRetry = (): void => {
|
||||
if (stopped || phase === "closed") return;
|
||||
if (retryTimer !== null) return;
|
||||
const delay = retryDelay;
|
||||
retryDelay = Math.min(retryDelay * 2, RETRY_MAX_MS);
|
||||
retryTimer = setTimeout(() => {
|
||||
retryTimer = null;
|
||||
attemptConnect();
|
||||
}, delay);
|
||||
};
|
||||
|
||||
const attemptConnect = (): void => {
|
||||
if (stopped) return;
|
||||
retryTimer = null;
|
||||
const sock = net.connect({ host: opts.host ?? "127.0.0.1", port: opts.port });
|
||||
wire(sock); // 先挂好 error/close 监听,事件最早下个 tick 才来
|
||||
const connectTimer = setTimeout(
|
||||
() => sock.destroy(new Error("connect timeout")),
|
||||
CONNECT_TIMEOUT_MS
|
||||
);
|
||||
sock.on("connect", () => {
|
||||
clearTimeout(connectTimer);
|
||||
retryDelay = RETRY_BASE_MS; // 成功即重置退避
|
||||
lastErrText = ""; // 允许下次断线后再报一次错误
|
||||
const first = !everConnected; // 快照必须在 setPhase 之前
|
||||
setPhase("connected");
|
||||
sys(
|
||||
first
|
||||
? `Connected to ${opts.host}:${opts.port}`
|
||||
: `Reconnected to ${opts.host}:${opts.port}`
|
||||
);
|
||||
});
|
||||
// 失败/超时统一走 wire 挂的 close handler → scheduleRetry,单出口
|
||||
};
|
||||
|
||||
if (role === "server") {
|
||||
server = net.createServer((sock) => {
|
||||
server?.close(); // 只接受第一个连入的人
|
||||
if (stopped) {
|
||||
sock.destroy(); // 与 close() 同 tick 进来的新连接,别在已关会话上复活状态
|
||||
return;
|
||||
}
|
||||
if (socket) teardownSocket(); // 替换旧连接
|
||||
wire(sock);
|
||||
lastErrText = "";
|
||||
const first = !everConnected; // 快照必须在 setPhase 之前
|
||||
setPhase("connected");
|
||||
sys("Peer connected");
|
||||
// connected→connected 的替换不触发 setPhase 内的 flush,显式兜底
|
||||
for (const payload of queue.splice(0)) sock.write(payload);
|
||||
sys(first ? "Peer connected" : "Peer reconnected");
|
||||
});
|
||||
server.on("error", (err) => {
|
||||
if (stopped) return;
|
||||
sys(`Listen failed: ${err.message}`);
|
||||
stopped = true; // listen 失败是终态,不自动重试
|
||||
teardownSocket();
|
||||
setPhase("closed");
|
||||
});
|
||||
server.listen(opts.port, () => {
|
||||
sys(`Waiting for peer on 0.0.0.0:${opts.port}…`);
|
||||
});
|
||||
} else {
|
||||
const sock = net.connect({ host: opts.host ?? "127.0.0.1", port: opts.port });
|
||||
wire(sock);
|
||||
sock.on("connect", () => {
|
||||
setPhase("connected");
|
||||
sys(`Connected to ${opts.host}:${opts.port}`);
|
||||
});
|
||||
attemptConnect(); // 启动即首次尝试,失败自动退避重试
|
||||
}
|
||||
|
||||
return {
|
||||
@@ -102,11 +210,18 @@ export function createSession(
|
||||
const payload =
|
||||
JSON.stringify({ type: "msg", name: opts.name, text, ts: Date.now() }) + "\n";
|
||||
if (phase === "connected") socket?.write(payload);
|
||||
else if (phase === "waiting") queue.push(payload);
|
||||
else if (phase === "waiting" || phase === "reconnecting") queue.push(payload);
|
||||
// closed 丢弃(终态)
|
||||
},
|
||||
close(): void {
|
||||
if (stopped) return; // 幂等
|
||||
stopped = true;
|
||||
if (retryTimer !== null) {
|
||||
clearTimeout(retryTimer);
|
||||
retryTimer = null;
|
||||
}
|
||||
teardownSocket();
|
||||
server?.close();
|
||||
socket?.end();
|
||||
setPhase("closed");
|
||||
},
|
||||
get phase(): Phase {
|
||||
|
||||
+27
-12
@@ -65,6 +65,9 @@ function App({ role, host, port, name }: UIOptions) {
|
||||
const [messages, setMessages] = useState<ChatMessage[]>([]);
|
||||
const [input, setInput] = useState("");
|
||||
const [phase, setPhase] = useState<Phase>("waiting");
|
||||
// 服务端 waiting 的两种含义(初始等待 vs 对方走了等重连)靠它区分;
|
||||
// 客户端天然由 phase === "reconnecting" 表达,不需要它
|
||||
const [everConnected, setEverConnected] = useState(false);
|
||||
const [cover, setCover] = useState(false); // 老板键开关
|
||||
const [plain, setPlain] = useState(true); // 低调渲染开关
|
||||
const [cursorOn, setCursorOn] = useState(true); // 自绘光标闪烁
|
||||
@@ -115,7 +118,10 @@ function App({ role, host, port, name }: UIOptions) {
|
||||
];
|
||||
});
|
||||
},
|
||||
onPhase: (p) => setPhase(p),
|
||||
onPhase: (p) => {
|
||||
if (p === "connected") setEverConnected(true);
|
||||
setPhase(p);
|
||||
},
|
||||
}
|
||||
);
|
||||
sessionRef.current = session;
|
||||
@@ -186,13 +192,17 @@ function App({ role, host, port, name }: UIOptions) {
|
||||
|
||||
if (cover) return <Cover />;
|
||||
|
||||
// 低调模式 footer:连接后显示原版权限模式行,等待/断开时显示状态
|
||||
// 低调模式 footer:连接后显示原版权限模式行,等待/重连/断开时显示状态
|
||||
const statusPlain =
|
||||
phase === "waiting"
|
||||
? role === "server"
|
||||
? `waiting for peer on 0.0.0.0:${port}…`
|
||||
: `connecting to ${host}:${port}…`
|
||||
: "disconnected · ctrl+c to exit";
|
||||
phase === "reconnecting"
|
||||
? `reconnecting to ${host}:${port}…`
|
||||
: phase === "waiting"
|
||||
? role === "server"
|
||||
? everConnected
|
||||
? `peer left · waiting for reconnect on 0.0.0.0:${port}…`
|
||||
: `waiting for peer on 0.0.0.0:${port}…`
|
||||
: `connecting to ${host}:${port}…`
|
||||
: "disconnected · ctrl+c to exit";
|
||||
const footerPlain =
|
||||
phase === "connected" ? (
|
||||
<>
|
||||
@@ -207,12 +217,17 @@ function App({ role, host, port, name }: UIOptions) {
|
||||
const statusText =
|
||||
phase === "connected"
|
||||
? `已连接 · 你是「${name}」`
|
||||
: phase === "waiting"
|
||||
? role === "server"
|
||||
? `等待对方连接 0.0.0.0:${port} …`
|
||||
: `正在连接 ${host}:${port} …`
|
||||
: "连接已断开,按 Ctrl+C 退出";
|
||||
: phase === "reconnecting"
|
||||
? "连接断开,自动重连中…"
|
||||
: phase === "waiting"
|
||||
? role === "server"
|
||||
? everConnected
|
||||
? `对方已断开,等待重连 0.0.0.0:${port} …`
|
||||
: `等待对方连接 0.0.0.0:${port} …`
|
||||
: `正在连接 ${host}:${port} …`
|
||||
: "连接已断开,按 Ctrl+C 退出";
|
||||
|
||||
// reconnecting/closed 都落 red,waiting 黄,connected 绿
|
||||
const borderColor =
|
||||
phase === "connected" ? "green" : phase === "waiting" ? "yellow" : "red";
|
||||
|
||||
|
||||
Reference in New Issue
Block a user