Windows下使用libssh SFTP下载文件出现损坏如何排查修复

问题根因 #

• Windows平台文件打开模式错误：C语言标准库的open函数在Windows环境下默认以文本模式打开文件，会自动对换行符做转换（LF替换为CRLF），遇到Ctrl+Z（0x1A）字符会判定为文件结束符，处理压缩包、可执行文件这类二进制文件时就会篡改原始字节流，刚好匹配你观测到的只有尾部字节存在差异的现象。
• 本地文件描述符未显式关闭：代码完成写入操作后没有调用close(fd)释放本地文件句柄，可能导致操作系统内核缓冲区中未刷入磁盘的尾部数据出现异常。

此前Dart版本代码运行正常，是因为Dart的文件IO接口默认以二进制模式处理文件，且垃圾回收机制会自动管理资源释放，不会触发Windows平台特有的文本模式转换问题。

修复方法 #

1. 修改本地文件打开逻辑，添加O_BINARY标记强制以二进制模式打开文件：

// 原代码：fd = open(fullLocalPath, O_CREAT | O_RDWR, 0777);
// 修改后：
fd = open(fullLocalPath, O_CREAT | O_RDWR | O_BINARY, 0777);

2. 写入完成后显式关闭本地文件描述符，确保缓冲区数据全部刷入磁盘：

for (;;) {
    // 原有读写逻辑保持不变
}
// 新增：关闭本地文件
close(fd);

rc = sftp_close(file);
// 原有后续逻辑保持不变

内容的提问来源于stack exchange，提问作者Isaque Neves