PyInstaller打包Python程序后邮件发送功能失效求助

可能的原因及对应解决方案 #

1. 邮件模块依赖未被正确打包 #

PyInstaller可能未自动识别邮件相关的隐藏依赖（如smtplib、email模块的子组件），需手动指定：

• 打包时添加--hidden-import参数：

  pyinstaller --hidden-import smtplib --hidden-import email.mime.text --hidden-import email.mime.multipart your_script.py
  

• 或创建spec文件，在hiddenimports列表中添加依赖，再执行pyinstaller your_script.spec完成打包。

2. 证书/配置文件路径异常 #

若使用SSL/TLS加密的SMTP服务，打包后exe可能无法找到系统证书或自定义配置文件：

• 显式指定证书路径：

  import ssl
  context = ssl.create_default_context(cafile=r"C:\your\cert\path\ca-bundle.crt")
  server = smtplib.SMTP_SSL('smtp.example.com', 465, context=context)
  

• 打包时将证书文件纳入资源，用--add-data参数：

  pyinstaller --add-data "ca-bundle.crt;." your_script.py
  

  代码中通过sys._MEIPASS获取打包后的资源路径：

  import sys, os
  cert_path = os.path.join(sys._MEIPASS, 'ca-bundle.crt') if hasattr(sys, '_MEIPASS') else 'ca-bundle.crt'
  

3. 网络请求被拦截 #

exe可能被系统防火墙或杀毒软件拦截SMTP端口的网络请求：

• 临时关闭防火墙/杀毒软件测试，确认是否为拦截导致。
• 给exe添加防火墙允许规则，授权其访问网络。

4. 邮箱账号权限问题 #

部分邮箱（如QQ、163）需开启授权码，且打包后运行环境的IP可能触发异地登录保护：

• 确认邮箱已开启POP3/SMTP服务，使用授权码而非登录密码。
• 登录邮箱后台，将exe运行环境的IP添加至信任列表。

5. 日志定位错误 #

在代码中添加异常捕获与日志输出，打包后运行exe查看具体错误：

import logging
logging.basicConfig(filename='email_error.log', level=logging.ERROR)
try:
    # 邮件发送逻辑代码
except Exception as e:
    logging.error(f"邮件发送失败: {str(e)}")

运行exe后查看生成的email_error.log，精准定位问题。

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