Django 配置 Email Admin 详细指南

---

概要

Django 是一个高级的 Python Web 框架，它鼓励快速开发和清洁、实用的设计。当你正在开发一个 Django 项目时，监控网站的运行情况是非常必要的。Django 提供了一个功能强大的 admin 界面，但同时也可以通过配置 email admin 来获取网站的错误报告和状态信息。在本文中，我们将详细探讨如何配置 Django 项目以通过电子邮件发送错误报告。

---

更新 settings.py 文件

首先，打开你的 Django 项目的 settings.py 文件，找到 EMAIL_BACKEND 配置。在默认情况下，它被设置为：

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'

然后，你需要配置 SMTP 的相关信息。例如：

EMAIL_HOST = 'your-smtp-server.com'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = 'your-email@example.com'
EMAIL_HOST_PASSWORD = 'your-email-password'
SERVER_EMAIL = EMAIL_HOST_USER

配置 Admins

在 settings.py 文件中，你需要配置 ADMINS 设置。这是一个包含所有管理员信息的元组，当网站出现错误时，错误报告将被发送到这些管理员的电子邮件地址。例如：

ADMINS = [('John Doe', 'john@example.com'), ('Jane Doe', 'jane@example.com')]

配置 Logging

还可以进一步配置 LOGGING 设置，以便于控制错误报告的详细程度和格式。以下是一个基本示例：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        "console": {
            "level": "INFO",
            "class": "logging.StreamHandler",
            "formatter": "verbose",
        },
        "mail_admins": {
            "level": "ERROR",
            "class": "django.utils.log.AdminEmailHandler",
            "formatter": "verbose",
            "include_html": True,
        },
    },
    "root": {
        "handlers": ["console", "mail_admins"],
        "level": os.getenv("DJANGO_LOG_LEVEL", "INFO"),
    },
    'loggers': {
        'django': {
            'handlers': ["console", 'mail_admins'],
            'level': os.getenv("DJANGO_LOG_LEVEL", "INFO"),
            'propagate': True,
        },
    },
}

这个配置将确保所有的错误都会通过电子邮件发送到管理员。

测试邮件发送

为了验证你的配置是否正确，你可以通过 Django shell 来发送测试邮件。运行以下命令来启动 shell：

python manage.py shell

然后，你可以使用以下命令来发送测试邮件：

import logging
logging.error("test err")

如果配置正确，你应该能在指定的电子邮件地址收到测试邮件。

检查错误报告

一旦你的 Django 项目出现错误，系统将自动将错误报告发送到配置的管理员邮箱中。错误报告包含了详细的错误信息，帮助你快速定位和修复问题。

总结

通过以上步骤，你应该已经成功配置了 Django 的 email admin 功能。这不仅可以帮助你更好地监控你的 Django 项目，也能在出现错误时快速接收到错误报告，进而及时修复问题，保证网站的稳定运行。