python smtplib自动发邮件总结
邮件协议介绍:
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
邮件传送代理 (Mail Transfer Agent,MTA) 程序使用SMTP协议来发送电邮到接收者的邮件服务器。SMTP协议只能用来发送邮件,不能用来接收邮件。大多数的邮件发送服务器 (Outgoing Mail Server) 都是使用SMTP协议。SMTP协议的默认TCP端口号是25。
SMTP协议的一个重要特点是它能够接力传送邮件。它工作在两种情况下:一是电子邮件从客户机传输到服务器;二是从某一个服务器传输到另一个服务器。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
POP协议和IMAP协议是用于邮件接收的最常见的两种协议。几乎所有的邮件客户端和服务器都支持这两种协议。
POP3协议为用户提供了一种简单、标准的方式来访问邮箱和获取电邮。使用POP3协议的电邮客户端通常的工作过程是:连接服务器、获取所有信息并保存在用户主机、从服务器删除这些消息然后断开连接。POP3协议的默认TCP端口号是110。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
IMAP协议也提供了方便的邮件下载服务,让用户能进行离线阅读。使用IMAP协议的电邮客户端通常把信息保留在服务器上直到用户显式删除。这种特性使得多个客户端可以同时管理一个邮箱。IMAP协议提供了摘要浏览功能,可以让用户在阅读完所有的邮件到达时间、主题、发件人、大小等信息后再决定是否下载。IMAP协议的默认TCP端口号是143。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
每封邮件都有两个部分:邮件头和邮件体,两者使用一个空行分隔。 邮件头每个字段 (Field) 包括两部分:字段名和字段值,两者使用冒号分隔。有两个字段需要注意:From和Sender字段。From字段指明的是邮件的作者,Sender字段指明的是邮件的发送者。如果From字段包含多于一个的作者,必须指定Sender字段;如果From字段只有一个作者并且作者和发送者相同,那么不应该再使用Sender字段,否则From字段和Sender字段应该同时使用。 邮件体包含邮件的内容,它的类型由邮件头的Content-Type字段指明。RFC 2822定义的邮件格式中,邮件体只是单纯的ASCII编码的字符序列。 MIME (Multipurpose Internet Mail Extensions) (RFC 1341) MIME扩展邮件的格式,用以支持非ASCII编码的文本、非文本附件以及包含多个部分 (multi-part) 的邮件体等。
smtplib和email介绍:
python发邮件需要掌握两个模块的用法,smtplib和email,这俩模块是python自带的,只需import即可使用。smtplib模块主要负责发送邮件,email模块主要负责构造邮件。
smtplib模块主要负责发送邮件:是一个发送邮件的动作,连接邮箱服务器,登录邮箱,发送邮件(有发件人,收信人,邮件内容)。
email模块主要负责构造邮件:指的是邮箱页面显示的一些构造,如发件人,收件人,主题,正文,附件等。
一。smtplib模块
smtplib使用较为简单。以下是最基本的语法。
导入及使用方法如下:
import smtplib smtp = smtplib.SMTP() smtp.connect('smtp.163.com,25') smtp.login(username, password) smtp.sendmail(sender, receiver, msg.as_string()) smtp.quit()
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
smtplib.SMTP():实例化SMTP() connect(host,port): host:指定连接的邮箱服务器。 port:指定连接服务器的端口号,默认为25. 常用邮箱的smtp服务器地址如下: 新浪邮箱:smtp.sina.com,新浪VIP:smtp.vip.sina.com,搜狐邮箱:smtp.sohu.com,126邮箱:smtp.126.com,139邮箱:smtp.139.com,163网易邮箱:smtp.163.com。 login(user,password): user:登录邮箱的用户名。 password:登录邮箱需要使用授权码,授权码即为客户端密码。 sendmail(from_addr,to_addrs,msg,...): from_addr:邮件发送者地址 to_addrs:邮件接收者地址。字符串列表['接收地址1','接收地址2','接收地址3',...]或'接收地址' msg:发送消息:邮件内容。一般是msg.as_string():as_string()是将msg(MIMEText对象或者MIMEMultipart对象)变为str。 quit():用于结束SMTP会话。
二。email模块
email模块下有mime包,mime英文全称为“Multipurpose Internet Mail Extensions”,即多用途互联网邮件扩展,是目前互联网电子邮件普遍遵循的邮件技术规范。
该mime包下常用的有三个模块:text,image,multpart。(超文本,图片,附件)
导入方法如下:
from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.image import MIMEImage from email.utils import formataddr from email.mime.base import MIMEBase from email import encoders
构造一个邮件对象就是一个Message
对象,如果构造一个MIMEText
对象,就表示一个文本邮件对象,如果构造一个MIMEImage
对象,就表示一个作为附件的图片,要把多个对象组合起来,就用MIMEMultipart
对象,而MIMEBase
可以表示任何对象。它们的继承关系如下:
Message
+- MIMEBase
+- MIMEMultipart
+- MIMENonMultipart
+- MIMEMessage
+- MIMEText
+- MIMEImage
查看MIMEText属性:可以观察到MIMEText,MIMEImage和MIMEMultipart的属性都一样。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
['__contains__', '__delitem__', '__doc__', '__getitem__', '__init__', '__len__', '__module__', '__setitem__', '__str__', '_charset', '_default_type', '_get_params_preserve', '_headers', '_payload', '_unixfrom', 'add_header', 'as_string', 'attach', 'defects', 'del_param', 'epilogue', 'get', 'get_all', 'get_boundary', 'get_charset', 'get_charsets', 'get_content_charset', 'get_content_maintype', 'get_content_subtype', 'get_content_type', 'get_default_type', 'get_filename', 'get_param', 'get_params', 'get_payload', 'get_unixfrom', 'has_key', 'is_multipart', 'items', 'keys', 'preamble', 'replace_header', 'set_boundary', 'set_charset', 'set_default_type', 'set_param', 'set_payload', 'set_type', 'set_unixfrom', 'values', 'walk']
2.text说明
邮件发送程序为了防止有些邮件阅读软件不能显示处理HTML格式的数据,通常都会用两类型分别为"text/plain"和"text/html"
构造MIMEText对象时,第一个参数是邮件正文,第二个参数是MIME的subtype,最后一定要用utf-8编码保证多语言兼容性。
2.1.1 添加普通文本
text = "Hi!\nHow are you?\nHere is the link you wanted:\nhttp://www.baidu.com"
text_plain = MIMEText(text,'plain', 'utf-8')
2.1.2 添加超文本
html = """ <html> <body> <p> Here is the <a href="http://www.baidu.com">link</a> you wanted. </p> </body> </html> """ text_html = MIMEText(html,'html', 'utf-8')
2.1.3 添加附件
sendfile=open(r'D:\pythontest\1111.txt','rb').read() text_att = MIMEText(sendfile, 'base64', 'utf-8') text_att["Content-Type"] = 'application/octet-stream' text_att["Content-Disposition"] = 'attachment; filename="显示的名字.txt"'
2.2 image说明
添加图片:
sendimagefile=open(r'D:\pythontest\testimage.png','rb').read() image = MIMEImage(sendimagefile) image.add_header('Content-ID','<image1>')
查看MIMEImage属性:
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
['__contains__', '__delitem__', '__doc__', '__getitem__', '__init__', '__len__', '__module__', '__setitem__', '__str__', '_charset', '_default_type', '_get_params_preserve', '_headers', '_payload', '_unixfrom', 'add_header', 'as_string', 'attach', 'defects', 'del_param', 'epilogue', 'get', 'get_all', 'get_boundary', 'get_charset', 'get_charsets', 'get_content_charset', 'get_content_maintype', 'get_content_subtype', 'get_content_type', 'get_default_type', 'get_filename', 'get_param', 'get_params', 'get_payload', 'get_unixfrom', 'has_key', 'is_multipart', 'items', 'keys', 'preamble', 'replace_header', 'set_boundary', 'set_charset', 'set_default_type', 'set_param', 'set_payload', 'set_type', 'set_unixfrom', 'values', 'walk']
2.3 multpart说明
常见的multipart类型有三种:multipart/alternative,multipart/related,multipart/mixed。
邮件类型为"multipart/alternative"的邮件包括纯文本正文(text/plain)和超文本正文(text/html)。
邮件类型为"multipart/related"的邮件正文中包括图片,声音等内嵌资源。
邮件类型为"multipart/mixed"的邮件包含附件。向上兼容,如果一个邮件有纯文本正文,超文本正文,内嵌资源,附件,则选择mixed类型。
我们必须把Subject,From,To,Date添加到MIMEText对象或者MIMEMultipart对象中,邮件中才会显示主题,发件人,收件人,时间(若无时间,就默认一般为当前时间,该值一般不设置)。 msg = MIMEMultipart('mixed') msg['Subject'] = 'Python email test' msg['From'] = 'XXX@163.com <XXX@163.com>' msg['To'] = 'XXX@126.com' msg['Date']='2012-3-16'
查看MIMEMultipart属性:
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
['__contains__', '__delitem__', '__doc__', '__getitem__', '__init__', '__len__', '__module__', '__setitem__', '__str__', '_charset', '_default_type', '_get_params_preserve', '_headers', '_payload', '_unixfrom', 'add_header', 'as_string', 'attach', 'defects', 'del_param', 'epilogue', 'get', 'get_all', 'get_boundary', 'get_charset', 'get_charsets', 'get_content_charset', 'get_content_maintype', 'get_content_subtype', 'get_content_type', 'get_default_type', 'get_filename', 'get_param', 'get_params', 'get_payload', 'get_unixfrom', 'has_key', 'is_multipart', 'items', 'keys', 'preamble', 'replace_header', 'set_boundary', 'set_charset', 'set_default_type', 'set_param', 'set_payload', 'set_type', 'set_unixfrom', 'values', 'walk']
说明:
msg.add_header(_name,_value,**_params):添加邮件头字段。 msg.as_string():是将msg(MIMEText对象或者MIMEMultipart对象)变为str,如果只有一个html超文本正文或者plain普通文本正文的话,一般msg的类型可以是 MIMEText;如果是多个的话,就都添加到MIMEMultipart,msg类型就变为MIMEMultipart。 msg.attach(MIMEText对象或MIMEImage对象):将MIMEText对象或MIMEImage对象添加到MIMEMultipart对象中。MIMEMultipart对象代表邮件本身, MIMEText对象或MIMEImage对象代表邮件正文。
以上的构造的文本,超文本,附件,图片都何以添加到MIMEMultipart('mixed')中:
msg.attach(text_plain)
msg.attach(text_html)
msg.attach(text_att)
msg.attach(image)
3.一下是使用实例:
实例一:(文字,html,图片,附件实现)
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
#coding: utf-8 import smtplib from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.image import MIMEImage from email.header import Header #设置smtplib所需的参数 #下面的发件人,收件人是用于邮件传输的。 smtpserver = 'smtp.163.com' username = 'XXX@163.com' password='XXX' sender='XXX@163.com' #receiver='XXX@126.com' #收件人为多个收件人 receiver=['XXX@126.com','XXX@126.com'] subject = 'Python email test' #通过Header对象编码的文本,包含utf-8编码信息和Base64编码信息。以下中文名测试ok #subject = '中文标题' #subject=Header(subject, 'utf-8').encode() #构造邮件对象MIMEMultipart对象 #下面的主题,发件人,收件人,日期是显示在邮件页面上的。 msg = MIMEMultipart('mixed') msg['Subject'] = subject msg['From'] = 'XXX@163.com <XXX@163.com>' #msg['To'] = 'XXX@126.com' #收件人为多个收件人,通过join将列表转换为以;为间隔的字符串 msg['To'] = ";".join(receiver) #msg['Date']='2012-3-16' #构造文字内容 text = "Hi!\nHow are you?\nHere is the link you wanted:\nhttp://www.baidu.com" text_plain = MIMEText(text,'plain', 'utf-8') msg.attach(text_plain) #构造图片链接 sendimagefile=open(r'D:\pythontest\testimage.png','rb').read() image = MIMEImage(sendimagefile) image.add_header('Content-ID','<image1>') image["Content-Disposition"] = 'attachment; filename="testimage.png"' msg.attach(image) #构造html #发送正文中的图片:由于包含未被许可的信息,网易邮箱定义为垃圾邮件,报554 DT:SPM :<p><img src="cid:image1"></p> html = """ <html> <head></head> <body> <p>Hi!<br> How are you?<br> Here is the <a href="http://www.baidu.com">link</a> you wanted.<br> </p> </body> </html> """ text_html = MIMEText(html,'html', 'utf-8') text_html["Content-Disposition"] = 'attachment; filename="texthtml.html"' msg.attach(text_html) #构造附件 sendfile=open(r'D:\pythontest\1111.txt','rb').read() text_att = MIMEText(sendfile, 'base64', 'utf-8') text_att["Content-Type"] = 'application/octet-stream' #以下附件可以重命名成aaa.txt #text_att["Content-Disposition"] = 'attachment; filename="aaa.txt"' #另一种实现方式 text_att.add_header('Content-Disposition', 'attachment', filename='aaa.txt') #以下中文测试不ok #text_att["Content-Disposition"] = u'attachment; filename="中文附件.txt"'.decode('utf-8') msg.attach(text_att) #发送邮件 smtp = smtplib.SMTP() smtp.connect('smtp.163.com') #我们用set_debuglevel(1)就可以打印出和SMTP服务器交互的所有信息。 #smtp.set_debuglevel(1) smtp.login(username, password) smtp.sendmail(sender, receiver, msg.as_string()) smtp.quit()
实例二:
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
#!/usr/bin/python # -*- coding:utf-8 -*- import smtplib from email.utils import formataddr from email.mime.text import MIMEText #超文本 from email.mime.multipart import MIMEMultipart from email.mime.base import MIMEBase from email import encoders from jx_analyze.conf import settings smtp = settings.SENDMAIL.get('smtp') port = settings.SENDMAIL.get('port') user = settings.SENDMAIL.get('user') password = settings.SENDMAIL.get('password') To = settings.ANALYZE_ALARM.get('To') subject = settings.ANALYZE_ALARM.get('subject') class EmailHandler(object): """ :param user:str 发送人邮箱地址(用户名) :param password:str 发送人邮箱申请的授权码 :param smtp:str 发送邮箱服务器地址 :param port:str 发送邮箱服务器端口号 """ _from = None _attachments = [] def __init__(self): self.smtp = smtp self.port = port self.user = user self.password = password self.server = smtplib.SMTP_SSL(self.smtp, self.port) self.server.login(self.user, self.password) self.To = To def add_attachment(self, filename): #添加附加 att = MIMEBase('application', 'octet-stream') att.set_payload(open(filename,'rb').read()) #get_payload(i=None, decode=False) :返回当前的有效载荷,这将是一个列表 Message lj_name = filename.split('\\')[-1] att.add_header('Content-Disposition', 'attachment', filename = ('utf-8','',lj_name)) #add_header(_name, _value, **_params) :扩展标题设置,_name为要添加的标题字段,_value为标题的值。 encoders.encode_base64(att) self._attachments.append(att) def send_mail(self,content,subject): """ :param To:str 接收人邮箱地址 :param subject:str 邮件标题 :param content:str 邮件内容 :return:bool True 成功 False 失败 """ try: self.add_attachment(r'D:\yunwei-dev\jx_analyze\report_file\2019-05-06日志统计.xls') msg = MIMEMultipart('mixed') contents = MIMEText(content, 'html', 'utf-8') msg['From'] = formataddr(['数据统计系统', self.user]) # msg['To'] = formataddr(['', To]) # 这个是自带的格式化 msg['To'] = ','.join(To) # msg['Subject'] = subject for att in self._attachments: msg.attach(att) msg.attach(contents) self.server.sendmail(self.user, To, msg.as_string()) print("[%s]邮件发送成功" % subject) return True except Exception as f: print("[%s]邮件发送失败,请检查信息" % subject) return False
模板一:纯文本格式的邮件模板
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
# coding=utf-8 import smtplib from email.mime.text import MIMEText # 发送纯文本格式的邮件 msg = MIMEText('hello,send by python_test...','plain','utf-8') #发送邮箱地址 sender = 'send@qq.com' #邮箱授权码,非登陆密码 password = '123456' #收件箱地址 receiver = 'test@qq.com' #smtp服务器 smtp_server = 'smtp.ym.163.com' #发送邮箱地址 msg['From'] = sender #收件箱地址 msg['To'] = receiver #主题 msg['Subject'] = 'from IMYalost' server = smtplib.SMTP(smtp_server,25) server.login(sender,password) server.sendmail(sender,receiver,msg.as_string()) server.quit()
模板二:带图片的HTML形式的邮件
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
#!/usr/bin/env python3 #coding: utf-8 import smtplib from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.image import MIMEImage sender = '***' receiver = '***' subject = 'python email test' smtpserver = 'smtp.163.com' username = '***' password = '***' msgRoot = MIMEMultipart('related') msgRoot['Subject'] = 'test message' msgText = MIMEText('<b>Some <i>HTML</i> text</b> and an image.<br><img src="cid:image1"><br>good!','html','utf-8') msgRoot.attach(msgText) fp = open('h:\\python\\1.jpg', 'rb') msgImage = MIMEImage(fp.read()) fp.close() msgImage.add_header('Content-ID', '<image1>') msgRoot.attach(msgImage) smtp = smtplib.SMTP() smtp.connect('smtp.163.com') smtp.login(username, password) smtp.sendmail(sender, receiver, msgRoot.as_string()) smtp.quit()
模板三:带附件的邮件
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
#!/usr/bin/env python3 #coding: utf-8 import smtplib from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.image import MIMEImage sender = '***' receiver = '***' subject = 'python email test' smtpserver = 'smtp.163.com' username = '***' password = '***' msgRoot = MIMEMultipart('related') msgRoot['Subject'] = 'test message' #构造附件 att = MIMEText(open('h:\\python\\1.jpg', 'rb').read(), 'base64', 'utf-8') att["Content-Type"] = 'application/octet-stream' att["Content-Disposition"] = 'attachment; filename="1.jpg"' msgRoot.attach(att) smtp = smtplib.SMTP() smtp.connect('smtp.163.com') smtp.login(username, password) smtp.sendmail(sender, receiver, msgRoot.as_string()) smtp.quit()
模板四:各种元素都包含的邮件
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
#!/usr/bin/env python3 #coding: utf-8 import smtplib from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.image import MIMEImage sender = '***' receiver = '***' subject = 'python email test' smtpserver = 'smtp.163.com' username = '***' password = '***' # Create message container - the correct MIME type is multipart/alternative. msg = MIMEMultipart('alternative') msg['Subject'] = "Link" # Create the body of the message (a plain-text and an HTML version). text = "Hi!\nHow are you?\nHere is the link you wanted:\nhttp://www.python.org" html = """\ <html> <head></head> <body> <p>Hi!<br> How are you?<br> Here is the <a href="http://www.python.org">link</a> you wanted. </p> </body> </html> """ # Record the MIME types of both parts - text/plain and text/html. part1 = MIMEText(text, 'plain') part2 = MIMEText(html, 'html') # Attach parts into message container. # According to RFC 2046, the last part of a multipart message, in this case # the HTML message, is best and preferred. msg.attach(part1) msg.attach(part2) #构造附件 att = MIMEText(open('h:\\python\\1.jpg', 'rb').read(), 'base64', 'utf-8') att["Content-Type"] = 'application/octet-stream' att["Content-Disposition"] = 'attachment; filename="1.jpg"' msg.attach(att) smtp = smtplib.SMTP() smtp.connect('smtp.163.com') smtp.login(username, password) smtp.sendmail(sender, receiver, msg.as_string()) smtp.quit()
三。SMTP发送邮件遇到的坑
3.1 协议问题
因为采用的是SMTP协议,那么需要确保自己的发送优邮箱地址开启了SMTP服务,否则,会报错
3.2 password 问题(重要的事情要说三遍!!!)
password需要输入邮箱授权码,而非邮箱登录密码!!!
password需要输入邮箱授权码,而非邮箱登录密码!!!
password需要输入邮箱授权码,而非邮箱登录密码!!!
3.3 各种报错信息排错
smtplib.SMTPDataError(553/554...)
根据报错里面的链接:see http://help.163.com/09/1224/17/5RAJ4LMH00753VB8.html,找到对应的问题,仔细检查代码,慢慢debug吧。。。
PS:如果收件邮箱的传输经过加密,必须经过SSL加密再STMP传输,出现554(发送的邮件内容包含了未被许可的信息,或被系统识别为垃圾邮件),发生了一件有趣的事情:
网易邮箱的处理结果是发生回退,即邮件发送失败,转回了收件箱。。。
QQ邮箱的处理结果,是将邮件放进垃圾邮件里面。。。
利用python对SMTP的内置封装支持,发送邮件的代码和注意事项基本就是以上几点,当然,其中的代码都是demo,具体实践过程还需要根据实际情况做调整。。。
四。邮件的小项目应用
http://python.jobbole.com/80897/