怎样在Python脚本后台运行时捕获异常并发送邮件告警

风晨吖_2847

风晨吖_2847

2026-09-05

464人浏览

原创

应通过sys.excepthook全局捕获未处理异常并邮件告警,配合threading.excepthook处理子线程,用traceback.format_exception获取完整堆栈,smtp连接需设timeout并降级写日志,密码须从环境变量读取。

怎样在python脚本后台运行时捕获异常并发送邮件告警

Python后台脚本崩溃时收不到报错?得让异常逃不出进程

后台运行的 python script.py & 或通过 systemd / supervisord 启动的脚本,一旦抛出未捕获异常,进程直接退出,标准错误(stderr)往往被丢弃或写入日志文件而无人查看。这不是“没报错”,是报错根本没被你看见。

关键不是等崩溃后翻日志,而是让异常主动“说话”——在它发生那一刻,发邮件到你的邮箱。

  • 必须用全局异常钩子:sys.excepthook 替换默认行为,它能捕获所有未被 try/except 拦下的异常(包括主线程顶层、线程内未处理异常)
  • 不要只依赖 try: ... except: ... 包裹主逻辑——后台脚本常含定时任务、长循环、多线程,漏掉一处就静默失败
  • 如果用 threading,记得对每个子线程单独设 threading.excepthook(Python 3.8+ 支持),否则子线程异常不会触发 sys.excepthook

用smtplib发邮件前,先确认SMTP服务是否真可用

本地开发时用 localhost:1025 + MailHog 测试很香,但上线后直连 Gmail 或企业邮箱常被拦截或要求 OAuth2。别等异常发生才试邮件通不通。

python-pro
python-pro

高级 Python 特性、异步编程、性能调优、静态类型、内存管理、Python 内部机制及生态库方面的专家。

下载
  • Gmail 需开启“应用专用密码”并关闭两步验证(或改用 OAuth2,但复杂度陡增),直接填密码会报 SMTPAuthenticationError
  • 国内企业邮箱(如腾讯企业邮、阿里云邮箱)通常禁用明文密码登录,必须用 SMTP over SSL/TLS,端口一般是 465 或 587,且需显式调用 server.starttls() 或 SMTP_SSL()
  • 测试命令比写完脚本再跑更快:python -c "import smtplib; s = smtplib.SMTP_SSL('smtp.qq.com', 465); s.login('xxx@qq.com', 'your_app_pwd'); print('OK')"

异常信息太简略?要完整 traceback 和上下文

sys.excepthook 给你的是 exc_type、exc_value、exc_traceback 三元组,直接 str() 它们只能拿到一行错误,看不出哪行代码、什么变量值出的问题。

  • 用 traceback.format_exception() 生成标准 traceback 字符串,和终端里看到的一模一样
  • 加上运行时上下文:当前时间、脚本路径、Python 版本、主机名(socket.gethostname()),方便区分多台机器上的同名脚本
  • 避免邮件正文过长被截断——把 traceback 放 <pre class="brush:php;toolbar:false;"></pre> 标签里(若发 HTML 邮件),或用 \n 换行的纯文本,确保可读
import traceback
import sys
def mail_excepthook(exc_type, exc_value, exc_tb):
    body = f"""\
Time: {datetime.now()}
Host: {socket.gethostname()}
Script: {sys.argv[0]}
Python: {sys.version}

{"".join(traceback.format_exception(exc_type, exc_value, exc_tb))}
"""
    send_mail("Alert: Script Crash", body)
sys.excepthook = mail_excepthook

邮件发不出去?得加超时和重试,否则异常本身又引发新异常

SMTP 连接卡住、网络抖动、认证失败……这些都会让 send_mail() 自己抛异常。如果这个函数也挂在 sys.excepthook 里,就会无限递归调用,最终栈溢出。

  • 给 smtplib.SMTP() 或 SMTP_SSL() 加 timeout=10 参数,防止卡死
  • 外层套 try/except 捕获邮件发送失败,并退化为写本地日志(print() 或 logging.error()),确保“告警失败”这件事至少还能被发现
  • 不建议自动重试多次——网络问题大概率持续存在,重试只会延迟故障感知;最多尝试 1 次,失败就落盘

最易忽略的一点:后台脚本若以非交互用户身份运行(如 www-data、nobody),可能无权访问密钥文件或环境变量。邮件密码别硬编码,用 os.getenv("MAIL_PASS"),并在启动环境里 export MAIL_PASS=xxx。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1671

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4164

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1669

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

24137

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2947

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2987

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1163

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2303

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程