使用CURL上传UTF-8编码CSV文件失败，请求技术支持

排查与修复步骤 #

1. 先确认本地CSV文件是真·UTF-8编码 #

大部分上传失败的根源是文件本身编码不对，先验证：

• Linux/macOS下执行命令查编码：

  file -I file.csv
  

  如果输出不是text/csv; charset=utf-8，转码成UTF-8（记得先备份原文件）：

  iconv -f 原编码（比如gbk） -t utf-8 file.csv > temp.csv && mv temp.csv file.csv
  

• Windows下用记事本打开文件，选「文件」-「另存为」，编码选「UTF-8」后保存。

2. 修正curl命令的核心错误 #

你原命令里少了@符号——curl需要用@来指定本地文件路径，这大概率是上传失败的关键，调整后的命令：

curl \
  --request POST \
  --url "你的API地址" \
  --form "file=@file.csv;type=text/csv;charset=utf-8"

如果API对文件名传递有要求，也可以加上filename参数：

curl \
  --request POST \
  --url "你的API地址" \
  -F "file=@file.csv;filename=file.csv;type=text/csv;charset=utf-8"

3. 开启调试模式看具体错误 #

加-v参数让curl输出请求细节和API的错误响应，能精准定位问题：

curl -v \
  --request POST \
  --url "你的API地址" \
  --form "file=@file.csv;type=text/csv;charset=utf-8"

从输出里重点看：请求头的编码声明是否正确，API返回的错误码和提示（比如文件大小超限、字段格式不匹配等）。

4. 强制二进制上传避免编码转换 #

如果系统默认编码不是UTF-8，curl可能偷偷转换文件编码，用--data-binary参数强制以二进制模式上传，保证文件编码完全不变：

curl \
  --request POST \
  --url "你的API地址" \
  --header "Content-Type: multipart/form-data" \
  -F "file=@file.csv;type=text/csv;charset=utf-8;filename=file.csv" \
  --data-binary @file.csv

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