fix(desktop): 连接失败给出可执行的排查方向,并分离配对与传输状态
实测中出现「连接码解析正确但连不上」。诊断结果不是代码问题:两台机器 同在 192.168.8.0/24,ARP 能解析对方 MAC(二层通),但 ICMP 100% 丢包、 TCP 39393 连接超时——典型的对端主机丢包,即 Windows 防火墙拦截入站。 顺带暴露的连带影响:二进制从 qft-windows.exe 改名为 qft-desktop.exe 后, 此前给旧名字放行的防火墙规则对新程序不生效,用户不会想到这一层。 README 已补充放行步骤与排查顺序。 代码侧的三个真实缺陷 1. 连接失败只说「失败」,等于什么都没说。现按 io::ErrorKind 分类: - TimedOut → 包发出去没回应:防火墙 / AP 客户端隔离 / 对方已关闭 - ConnectionRefused → 主机在线但端口没人监听:对方没点「启动接收」 - Host/NetworkUnreachable → 本机没有到该地址的路由 三者成因完全不同,给的建议也必须不同。 2. 配对超时从 10 秒缩到 4 秒。配对只是一次极小的请求,拖到 10 秒 只会让用户以为程序卡死。 3. 配对阶段就显示「正在发送 0%」。此前用 busy 兼作「正在传输」, 导致刚点连接就出现发送进度条。新增独立的 transferring 标志, 进度块只在真正推送文件时出现;配对期间改为显示 spinner 与 「正在建立连接…最多等 4 秒」。 验证:cargo test 32/32。新增两项针对错误分类的用例—— 用 RFC 5737 文档网段 192.0.2.1 触发超时路径,用刚释放的本地端口 触发拒绝路径,分别断言提示里包含对应的排查方向。
This commit is contained in:
+14
-2
@@ -136,6 +136,9 @@ struct PcPeerState {
|
||||
// 后台事件
|
||||
events: Option<mpsc::Receiver<PcEvent>>,
|
||||
busy: bool,
|
||||
/// 仅在真正开始推送文件后为真。此前用 busy 兼作此用,
|
||||
/// 导致配对阶段就显示「正在发送 0%」,误导用户以为传输已经开始。
|
||||
transferring: bool,
|
||||
current_file: String,
|
||||
done: u64,
|
||||
total: u64,
|
||||
@@ -228,6 +231,7 @@ impl QftApp {
|
||||
files: Vec::new(),
|
||||
events: None,
|
||||
busy: false,
|
||||
transferring: false,
|
||||
current_file: String::new(),
|
||||
done: 0,
|
||||
total: 0,
|
||||
@@ -985,6 +989,7 @@ impl QftApp {
|
||||
self.receive.events = None;
|
||||
self.pc.events = None;
|
||||
self.pc.busy = false;
|
||||
self.pc.transferring = false;
|
||||
self.pc.token = None;
|
||||
self.pc.connected_base = None;
|
||||
}
|
||||
@@ -1003,6 +1008,7 @@ impl QftApp {
|
||||
});
|
||||
ui.add_space(10.0);
|
||||
ui.label(egui::RichText::new(&self.pc.status).weak());
|
||||
// 失败原因常常是多行的排查建议,需要完整展示而不是被截断
|
||||
ui.add_space(10.0);
|
||||
|
||||
match self.pc.mode {
|
||||
@@ -1116,7 +1122,10 @@ impl QftApp {
|
||||
{
|
||||
self.pair_pc_peer();
|
||||
}
|
||||
if self.pc.token.is_some() {
|
||||
if self.pc.busy {
|
||||
ui.spinner();
|
||||
ui.weak("正在建立连接…最多等 4 秒");
|
||||
} else if self.pc.token.is_some() {
|
||||
ui.colored_label(egui::Color32::from_rgb(80, 200, 120), "● 已连接");
|
||||
}
|
||||
});
|
||||
@@ -1171,7 +1180,7 @@ impl QftApp {
|
||||
ui.label(format!("• {} {}", file.display(), human_bytes(size)));
|
||||
}
|
||||
|
||||
if self.pc.busy || self.pc.total > 0 {
|
||||
if self.pc.transferring || self.pc.total > 0 {
|
||||
ui.add_space(8.0);
|
||||
ui.label(format!("正在发送:{}", self.pc.current_file));
|
||||
let fraction = if self.pc.total == 0 { 0.0 }
|
||||
@@ -1247,6 +1256,7 @@ impl QftApp {
|
||||
let (tx, rx) = mpsc::channel();
|
||||
self.pc.events = Some(rx);
|
||||
self.pc.busy = true;
|
||||
self.pc.transferring = true;
|
||||
self.pc.done = 0;
|
||||
self.pc.total = total;
|
||||
self.pc.started = Some(Instant::now());
|
||||
@@ -1316,11 +1326,13 @@ impl QftApp {
|
||||
}
|
||||
PcEvent::AllDone => {
|
||||
self.pc.busy = false;
|
||||
self.pc.transferring = false;
|
||||
self.pc.current_file.clear();
|
||||
self.pc.status = "全部发送完成。".into();
|
||||
}
|
||||
PcEvent::Failed(message) => {
|
||||
self.pc.busy = false;
|
||||
self.pc.transferring = false;
|
||||
self.pc.status = message;
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user