使用libcurl开发FTP客户端下载时CRLF被替换为LF如何解决？

根本原因 #

• 你直接使用CURLOPT_CUSTOMREQUEST手动发送RETR指令的方式，绕过了libcurl内置的FTP传输状态管理逻辑，你之前设置的二进制传输相关参数（CURLOPT_TRANSFERTEXT、CURLOPT_CRLF、手动发送的TYPE I）都没有被关联到本次下载会话，libcurl默认按ASCII传输模式处理换行符转换，导致Windows服务端的CRLF被自动替换为Linux侧的LF。
• 隐形附加坑：如果手动发送TYPE I之后没有保持同一个FTP连接就发起下载请求，FTP会话状态重置会导致传输模式恢复默认ASCII，也会触发换行转换问题。

解决方法 #

方案1：使用libcurl标准FTP下载流程（推荐） #

不要手动构造RETR请求，改用libcurl内置的FTP下载逻辑，传输模式设置会自动生效，示例代码如下：

// 省略curl初始化、鉴权参数配置逻辑
FILE *newfile = fopen(newfilePath.c_str(), "wb");
// 构造完整FTP资源路径，格式为 ftp://[用户名:密码@]服务端地址/文件路径
std::string full_ftp_url = "ftp://" + user + ":" + passwd + "@" + server_addr + "/" + file;
curl_easy_setopt(curl, CURLOPT_URL, full_ftp_url.c_str());
// 明确指定二进制传输模式
curl_easy_setopt(curl, CURLOPT_TRANSFERTEXT, 0L);
curl_easy_setopt(curl, CURLOPT_CRLF, 0L);
// 配置文件写入参数
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, fwrite);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, newfile);
// 直接执行下载，libcurl会自动发起RETR请求并应用二进制模式配置
CURLcode res = curl_easy_perform(curl);
// 省略错误处理、curl资源释放逻辑
fclose(newfile);

方案2：必须使用自定义REQUEST流程的适配方案 #

如果业务逻辑要求必须手动控制FTP指令发送，需要保证TYPE I指令和RETR指令在同一个FTP连接中发送：

• 提前设置curl_easy_setopt(curl, CURLOPT_FTP_USE_EPSV, 0L)关闭EPSV避免连接重置
• 先使用CURLOPT_CUSTOMREQUEST发送TYPE I指令，执行成功后不要断开连接、不要重新初始化curl句柄
• 再发送RETR请求，全程保持CURLOPT_TRANSFERTEXT为0的配置

效果验证 #

下载完成后执行hexdump -C 目标文件名查看二进制内容，换行位置显示0d 0a即说明CRLF已成功保留。

内容的提问来源于stack exchange，提问作者emma-fm