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

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。别等异常发生才试邮件通不通。
- 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 的核心概念和高级技巧!











