使用Python smtplib发送邮件时,xlsx、pdf附件接收后变为.bin扩展名问题
附件显示为.bin的核心原因
- 头格式不合规:原代码硬拼字符串生成
Content-Disposition头,未按RFC邮件标准对文件名做编码处理,Gmail等服务商的出口网关会直接丢弃不合规的头字段,接收端读不到文件名时会自动将附件标记为.bin后缀。 - 附件名携带路径:原代码直接把传入的文件完整路径作为附件名写入头,路径中的斜杠符号会触发网关的安全校验,直接清除文件名信息。
- MIME识别偏差:依赖系统自带
mimetypes库做类型识别,部分环境会将openpyxl生成的xlsx文件识别为通用application/zip,触发可疑文件标记,被网关重命名为.bin。 - 传输编码截断:原代码使用
mime.as_string()输出邮件内容,该方法处理二进制内容时容易出现编码截断,导致头信息丢失。
修复后的可运行代码
from smtplib import SMTP from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.base import MIMEBase from email import encoders from email.header import Header from os.path import basename import mimetypes # 手动兜底常见文件的MIME类型,避免系统识别偏差 MIME_TYPE_OVERRIDE = { ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", ".pdf": "application/pdf", ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", ".zip": "application/zip" } def get_att_mime(path): mimetypes.init() file_ext = "." + path.split(".")[-1].lower() # 优先使用手动定义的MIME类型 if file_ext in MIME_TYPE_OVERRIDE: mimetype = MIME_TYPE_OVERRIDE[file_ext] else: mimetype, _ = mimetypes.guess_type(path) if mimetype is None: mimetype = 'application/octet-stream' type_, _, subtype = mimetype.partition('/') return MIMEBase(type_, subtype) def create_mime(d): mime_multipart = MIMEMultipart() mime_multipart['From'] = d["From"] mime_multipart['To'] = d["To"] mime_multipart['Subject'] = Header(d["Subject"], "utf-8").encode() mime_multipart.attach(MIMEText(d["msg"], _charset="utf-8")) return mime_multipart def add_file_list(mime, file_path_list=[]): [add_file(mime, file_path) for file_path in file_path_list] def add_file(mime, file_path): # 只取纯文件名,剥离路径部分 file_name = basename(file_path) with open(file_path, "rb") as attachment: att_mime = get_att_mime(file_path) att_mime.set_payload(attachment.read()) encoders.encode_base64(att_mime) # 按标准编码文件名,写入双份头信息做冗余备份 encoded_name = Header(file_name, "utf-8").encode() att_mime.add_header('Content-Disposition', "attachment", filename=encoded_name) att_mime.add_header('Content-Type', att_mime.get_content_type(), name=encoded_name) mime.attach(att_mime) def create_smtp_session(d): s = SMTP('smtp.gmail.com', 587) s.starttls() s.login(d["From"], d["sender_password"]) return s def send_mail(d): mime = create_mime(d) add_file_list(mime, d["filename_list"]) try: s = create_smtp_session(d) # 改用as_bytes()避免编码截断问题 s.sendmail(d["From"], d["To"], mime.as_bytes()) except Exception as e: print(e) print("échec de l'envoi de mail") print(d) return -1 s.quit() print("envoi de mail réussi") return 0 if __name__ == "__main__": d = { "From": "YOUREMAIL.com", "To": "FINALUSEREMAIL.fr", "Subject": "Sujet du mail", "sender_password": "YOUREMAILPASSWORD", "msg": "Bonjour,\n\nTexte du message.\n\nCordialement,", "filename_list": ["model.xlsx","model.pdf"] } state = send_mail(d)
修复点说明
- 新增常见文件MIME类型兜底映射,彻底解决系统库识别xlsx为zip类型的问题
- 所有涉及非ASCII的头内容(主题、附件名)全部按utf-8标准编码,符合RFC邮件规范
- 附件名只取纯文件名,不携带路径信息,避免触发安全网关拦截
- 同时在
Content-Disposition和Content-Type头中写入附件名,做冗余备份,就算单个头被清除也能正确识别后缀 - 改用
as_bytes()输出邮件内容,避免字符串模式下的编码截断问题 - 用上下文管理器打开文件,避免文件句柄泄漏
内容的提问来源于stack exchange,提问作者user14234656
相关产品推荐
相关产品推荐

