Django中Cronjob定时发邮件：虚拟环境内外SMTP连接异常排查

以下是导致该差异的核心原因及对应解决方向：

核心原因 #

• 环境变量缺失
  虚拟环境激活时通常会加载项目专属的环境变量（比如通过.env文件或activate脚本注入），但虚拟环境外或cron执行时不会自动加载这些变量。如果你的Django邮件配置（如EMAIL_HOST_PASSWORD、EMAIL_PORT等）依赖环境变量，虚拟环境外执行时这些变量为空，会导致SMTP连接参数错误，触发SMTPServerDisconnected异常。

• Python环境与依赖不匹配
  虚拟环境外使用的是系统默认Python解释器，和虚拟环境内的独立Python环境存在依赖版本差异。比如系统Python的smtplib、Django版本与虚拟环境内不一致，可能导致邮件发送逻辑出现兼容性问题，引发连接失败。

• Django配置加载错误
  执行manage.py时，Django依赖DJANGO_SETTINGS_MODULE环境变量定位配置文件。虚拟环境外未设置该变量的话，Django可能加载错误的配置（比如默认开发配置而非生产配置），其中SMTP参数配置不正确，导致无法建立连接。

• Cron执行环境的特殊性
  即便你在虚拟环境内添加了定时任务，cron的执行环境和用户登录shell完全不同：

  • cron不会自动激活虚拟环境，必须在任务命令中明确指定虚拟环境的Python绝对路径
  • cron的默认环境变量极少，不会加载用户.bashrc/.profile中的变量，导致邮件配置所需的环境变量无法被Django读取

解决方向 #

• 补全环境变量：在虚拟环境外执行命令前，手动加载项目的.env文件，或在cron任务中直接设置所需环境变量。例如：

  */5 * * * * cd /path/to/your/project && export $(cat .env | xargs) && /path/to/venv/bin/python3 manage.py crontab run <job_hash>
  

• 指定虚拟环境Python路径：在cron任务中使用虚拟环境的Python绝对路径，避免调用系统Python。例如：

  */5 * * * * /path/to/your/venv/bin/python3 /path/to/your/project/manage.py crontab run <job_hash>
  

• 明确配置模块：执行命令前导出DJANGO_SETTINGS_MODULE，确保Django加载正确的配置：

  export DJANGO_SETTINGS_MODULE=your_project.settings.production && /path/to/venv/bin/python3 manage.py crontab run <job_hash>
  

• 对比环境变量差异：分别在虚拟环境内外执行printenv命令，找出缺失的邮件相关配置变量，确保在非虚拟环境执行时补全这些变量。

内容的提问来源于stack exchange，提问作者Stefan Boehringer