传输失败与中断：报错含义与重试

传输失败的表现五花八门，但状态词是固定的。这一页把进度页和发送页出现过的状态逐个解释，并给出对应的处理。

状态词词典

高频失败场景与修复

场景一：发送时连接失败、进度条直接报错

传输建立在直连之上，报错多发生在"发现成功但直连失败"的网络里。先手动输入对方 IP 验证连通性（方法见手动输入 IP 直连），通了再加收藏；不通按防火墙与隔离排查（防火墙放行、AP 隔离）。

场景二：iOS 端传到一半断

iOS 要求应用保持前台，锁屏或切走就会中断。传大文件时关闭自动锁定，或分批传，见平台支持。

场景三：接收端报错、文件没落全

先查接收端剩余空间（见保存目录设置），再查目录写入权限（外置存储授权失效是常见原因）。

场景四：启动时报端口占用

套接字创建失败通常是 53317 被别的程序占了，两端同步换端口重试，步骤见防火墙放行。

重试策略：没有断点续传

传输不支持断点续传，失败重来会从头开始。所以大任务要主动拆：

• 几个GB的目录按子目录分批发。
• 几百张照片按拍摄日分批。
• 网络高峰期不传超大文件，改在夜间或直连环境下传。

分批的另一好处：一批里只有个别失败时，重发成本极小。

仍然失败的兜底

把两端应用都完全退出重开（清掉可能的半死服务状态，v1.18.2 起服务异常会自动重启，但手动重启仍是最直接的清场手段），再不行就换热点网络验证——热点下能传通，问题一定在原网络环境，回到搜不到设备对照排查。