Flask send_file发送CSV丢失BOM致Excel UTF-8字符显示异常

问题根源 #

核心问题在于：浏览器处理text/csv类型附件时，若仅通过Content-Type指定charset=utf-8，部分浏览器会自动移除UTF-8 BOM，导致Excel无法识别正确编码，最终特殊字符显示异常。Postman能正常接收是因为它不会修改响应内容，而浏览器的下载逻辑会做额外编码调整。

解决方案 #

直接在原始CSV字节流开头添加UTF-8 BOM（\xef\xbb\xbf），同时优化响应头设置，确保浏览器完整保留BOM并正确识别文件名编码。

修正后的代码 #

方法1：优化send_file用法

from flask import send_file
from datetime import datetime
import io

# 假设你的原始CSV数据是utf-8编码的bytes（如果是str，先转成bytes：csv_str.encode('utf-8')）
raw_csv_bytes = ...  

# 手动添加UTF-8 BOM
bom = b'\xef\xbb\xbf'
csv_with_bom = bom + raw_csv_bytes
response_io = io.BytesIO(csv_with_bom)
response_io.seek(0)

filename = f'report {datetime.now().strftime("%Y-%m-%d %H-%M-%S")}.csv'

return send_file(
    response_io,
    download_name=filename,
    as_attachment=True,
    mimetype='text/csv; charset=utf-8',
    # 额外设置Content-Disposition确保文件名编码正确
    headers={
        'Content-Disposition': f'attachment; filename*=UTF-8\'\'{filename}'
    }
)

方法2：用make_response直接构造响应（更可控）

from flask import make_response
from datetime import datetime

raw_csv_bytes = ...  # 原始UTF-8编码的CSV字节数据
bom = b'\xef\xbb\xbf'
csv_with_bom = bom + raw_csv_bytes

filename = f'report {datetime.now().strftime("%Y-%m-%d %H-%M-%S")}.csv'

response = make_response(csv_with_bom)
# 用RFC 5987标准格式指定文件名，避免中文乱码
response.headers['Content-Disposition'] = f'attachment; filename*=UTF-8\'\'{filename}'
response.headers['Content-Type'] = 'text/csv; charset=utf-8'
return response

关键说明 #

1. 避免冗余编码操作：原代码中response.read().encode("utf-8-sig")会将字节流先解码为字符串（可能因编码不匹配出错）再重新编码，直接操作字节流添加BOM更可靠。
2. 文件名编码：使用filename*=UTF-8''格式符合RFC标准，能兼容绝大多数浏览器，解决中文文件名乱码问题。
3. 验证BOM存在：下载文件后，用十六进制编辑器查看开头是否有EF BB BF，确认BOM未被浏览器移除。

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