向日葵远程传输压缩文件校验失败如何排查？
向日葵远程传输压缩文件校验失败时，用日志抓MD5、比对分片、重传差异块，三步定位并修复。
功能定位：为什么压缩包最容易校验失败
向日葵远程传输采用类 FTP 分片协议，单文件最大 500 GB，断点续传依赖「分片 MD5 哈希表」做完整性校验。压缩文件（.zip/.rar/.7z）内部结构连续，一旦某一 4 MB 分片出现比特翻转，整包即被判定损坏，触发「校验失败」提示。经验性观察：在 5% 丢包率的移动宽带下，压缩包校验失败概率约为普通文档的 3 倍。
现象速查：先确认是哪一级报错
向日葵客户端在传输面板提供三级提示：①传输中红色叹号→分片重试超限；②传输完成红色叉→整包校验不一致；③双击任务出现「文件校验失败，是否重新下载？」弹窗。记录提示等级，再决定后续排查深度，可避免盲目全量重传。
快速复现：手动触发校验日志
主控端顶部菜单【设置→日志→传输调试】勾选「记录分片哈希」，随后重新传输同一压缩包。日志默认写入安装目录 logs/transfer-yyyy-mm-dd.log，无需重启客户端即可生效。
排查路径 A：本地哈希比对法
1. 在文件发送端，用任意工具生成整包 MD5，记为 MD5_Origin。
2. 传输失败后，在接收端右键任务→「打开所在目录」，对残留文件同样生成 MD5，记为 MD5_Fail。
3. 若 MD5_Fail 与 MD5_Origin 一致，却仍提示失败，说明向日葵的「分片哈希表」与「整包哈希」冲突，属于客户端显示缺陷，可直接重命名残留文件后使用；若不一致，继续路径 B。
平台差异：移动端无法直接生成 MD5
Android/iOS 被控端无内置哈希工具，可在向日葵文件管理器长按压缩包→「属性」查看「云端哈希」。若该字段为空，说明分片表未上传成功，需回到桌面端重新推送。
排查路径 B：日志定位损坏分片
打开 logs/transfer-yyyy-mm-dd.log，搜索关键字「piece=」与「checksum mismatch」。日志格式示例：piece=137, offset=0x224000, len=4MB, expect=8fa9b3…, actual=71c4d2…。记录 piece 序号，回到发送端用十六进制编辑器跳转到对应偏移量，手动提取 4 MB 数据再次计算 MD5，即可确认是否为源文件损坏。
提示：若日志中连续出现 10 个以上分片不匹配，经验性观察多为上行带宽瞬时掉线，可优先检查路由器 UDP 443 是否被封，而非文件本身。
修复方案：差异块重传与局域网加速
向日葵 v15.3.1 起内置「差异同步」按钮，位于传输任务右键菜单→「高级→重传损坏分片」。客户端会仅拉取 piece 哈希表中标记为 bad 的块，节省 90% 以上流量。若两端在同一局域网，可勾选「优先 LAN 直连」，走 SAMBA 穿透通道，绕过中继服务器，经验性观察可把重传时间从数十分钟缩短到两分钟以内。
回退方案：关闭压缩包完整性检查
在【设置→传输→高级】关闭「传输完成后校验文件哈希」，可强制标记任务为成功。此操作会留下审计缺口，仅建议在临时演示、且后续会人工用解压测试验证的场景使用。
网络侧兜底：抓包确认 UDP 是否被限
若差异块重传仍失败，可用 Wireshark 过滤「udp.port==443」观察 SunUDP-NAT 心跳。发现大量「ICMP administratively prohibited」即说明上行被运营商丢弃。此时可在【设置→连接】切换「强制 TCP 中继」，牺牲 20% 速度换取稳定性，或联系运营商申请开放 UDP 443。
合规与审计：如何留存排查证据
企业版控制台提供「传输日志归档」开关，开启后所有 piece 级哈希、失败原因码自动上传到云端 bucket，保存 180 天。IT 管理员可在【审计→远程文件→导出】生成 CSV，包含字段：任务 ID、文件名、失败 piece 序号、客户端版本、公网 IP。该文件可直接用于内部 SLA 考核，无需人工截图。
最小权限原则
仅给需要排查故障的账号授予「日志下载」权限，避免普通员工批量导出敏感文件哈希。控制台支持对单台设备临时授权 24 小时，到期自动回收。
不适用场景清单
- 源文件本身已损坏：差异重传无法解决，需重新打包。
- 压缩包采用固实模式且分卷：向日葵按 4 MB 对齐分片，可能跨越卷边界，导致 piece 哈希失效，建议关闭固实后重传。
- 被控端磁盘开启实时去重（Windows Server Data Deduplication）：读取时可能返回陈旧块，需临时关闭去重任务。
最佳实践速查表
- 传输前先在发送端生成整包 MD5 并写入文件名，便于后续比对。
- 大于 1 GB 的压缩包建议关闭「固实压缩」，降低单点损坏概率。
- 开启「日志调试」仅维持 48 小时，排查完成后及时关闭，防止磁盘爆满。
- 跨运营商场景优先使用「TCP 中继」，牺牲速度换穿透成功率。
- 差异重传后，务必用解压命令「tar -tf」或「7z t」做二次验证，并留存返回码截图。
FAQ：向日葵远程传输压缩文件校验失败
为什么只有压缩包会失败，普通视频正常？
压缩包内部结构对连续比特敏感，单分片翻转即导致整包 CRC 失效；视频流可容忍局部花屏，播放器会自动插值，所以不易触发校验失败提示。
差异重传按钮灰色无法点击？
任务状态必须为「已完成(校验失败)」且日志已记录 piece 哈希。若任务被手动删除或关闭校验功能，则无法回溯，只能整包重新下载。
局域网加速仍失败，如何确认走直连？
在传输面板右上角点击「节点信息」，若显示「Relay: none, P2P: UDP 50000」即已直连；若仍走「Relay: TCP Beijing」，说明路由器未放行 UDP 50000-50100，需在防火墙添加放行规则。
收尾：三步行动建议
首先，在发送端生成 MD5 并记录，建立基准；其次，开启传输调试日志，通过 piece 序号精准定位损坏分片；最后，用差异重传+局域网加速完成修复，并在控制台导出 CSV 留存审计。若仍失败，切换 TCP 中继或人工关闭校验，但务必在解压测试通过后再关闭工单。如此即可把「向日葵远程传输压缩文件校验失败」的排障时间从数小时压缩到十分钟以内。