Windows 11 Docker容器内cURL下载SharePoint PDF文件异常求助

核心现象 #

Windows 11主机Shell执行curl下载SharePoint PDF正常，但Debian Docker容器及MobaXterm中执行相同命令时，PDF文件损坏，大小异常（小于或大于预期），已排除MTU问题。

排查方向与解决办法 #

1. 强制cURL以原始二进制模式传输 #

Windows与Linux环境下cURL对二进制文件的默认处理可能存在差异，尤其是换行符转换或编码处理。添加--raw参数强制按原始字节流传输，避免内容被修改：

curl --location --raw "https://xxx.sharepoint.com/sites/xxx/_api/web/GetFolderByServerRelativeUrl('/sites/xxx/Shared%20Documents/xxx')/Files('file.pdf')/$value" --header "Authorization: Bearer xxx" --output file.pdf

也可尝试用重定向替代--output参数，避免cURL内部的输出处理逻辑干扰：

curl --location --raw "https://xxx.sharepoint.com/sites/xxx/_api/web/GetFolderByServerRelativeUrl('/sites/xxx/Shared%20Documents/xxx')/Files('file.pdf')/$value" --header "Authorization: Bearer xxx" > file.pdf

2. 统一字符编码环境 #

容器或MobaXterm中的字符编码设置可能导致二进制文件输出异常，临时设置编码为原始ASCII模式后执行curl：

LC_ALL=C curl --location "https://xxx.sharepoint.com/sites/xxx/_api/web/GetFolderByServerRelativeUrl('/sites/xxx/Shared%20Documents/xxx')/Files('file.pdf')/$value" --header "Authorization: Bearer xxx" --output file.pdf

3. 检查cURL版本与自动解压行为 #

不同版本cURL对HTTP压缩的处理可能不一致，先查看容器内cURL版本：

curl --version

若版本较旧，在Dockerfile的openjdk:21-jdk-slim阶段更新cURL：

RUN apt-get update && apt-get install -y curl --no-install-recommends && rm -rf /var/lib/apt/lists/*

同时，强制统一压缩处理行为，添加--compressed（强制解压）或--no-compressed（禁止解压）参数：

# 强制解压压缩响应
curl --location --compressed "https://xxx.sharepoint.com/sites/xxx/_api/web/GetFolderByServerRelativeUrl('/sites/xxx/Shared%20Documents/xxx')/Files('file.pdf')/$value" --header "Authorization: Bearer xxx" --output file.pdf

# 禁止解压
curl --location --no-compressed "https://xxx.sharepoint.com/sites/xxx/_api/web/GetFolderByServerRelativeUrl('/sites/xxx/Shared%20Documents/xxx')/Files('file.pdf')/$value" --header "Authorization: Bearer xxx" --output file.pdf

4. 避免文件系统的自动换行转换 #

若容器中下载路径为Windows绑定挂载目录，Docker Desktop可能自动转换CRLF/LF换行符，破坏二进制文件。解决办法：

• 先将PDF下载到容器内部临时目录（如/tmp），再复制到挂载目录
• 在Docker Desktop设置中，关闭共享驱动器的“Enable automatic CRLF conversion”选项

5. Wireshark抓包重点 #

若以上方法无效，抓包时重点对比Windows主机与容器的TCP会话：

• 检查响应头Content-Length与实际接收字节数是否匹配
• 排查是否存在TCP重传、丢包或乱序
• 对比Content-Encoding头的处理，确认两端cURL是否对压缩响应做了相同处理
  建议先通过curl -v查看详细请求响应日志，快速定位差异：

curl -v --location "https://xxx.sharepoint.com/sites/xxx/_api/web/GetFolderByServerRelativeUrl('/sites/xxx/Shared%20Documents/xxx')/Files('file.pdf')/$value" --header "Authorization: Bearer xxx" --output file.pdf

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