xxl-job配置邮箱

### 如何配置 xxl-job 使用电子邮件通知/警报

#### 配置邮件服务器参数
为了使 XXL-JOB 能够发送邮件告警，首先需要在 `application.properties` 文件中正确配置邮件服务的相关参数。这些参数通常包括 SMTP 服务器地址、端口、用户名和密码等。

xxl.job.mail.smtp.host=smtp.example.com
xxl.job.mail.smtp.port=587
xxl.job.mail.username=user@example.com
xxl.job.mail.password=yourpassword
xxl.job.mail.from.user=admin@example.com

上述配置项用于指定连接至外部 SMTP 服务器所需的信息[^1]。

#### 设置告警接收者列表
接着，在管理员界面中的“执行器管理”页面下找到目标执行器，并编辑其属性以添加告警联系人的邮箱地址。这一步骤确保当任务失败或其他异常情况发生时能够向特定人员发出警告。

#### 启用告警功能
最后也是最重要的一步是在触发器（Trigger）定义里开启相应的告警选项。对于每一个计划运行的任务都可以单独设定是否启用错误告警以及选择合适的告警方式——这里即为通过 Email 进行通报。

一旦完成了以上三步操作之后，每当有作业未能正常完成的时候就会自动激活预先设置好的邮件提醒流程了[^2]。

from xxl_job import XxlJobClient, JobHandler

@JobHandler(name='example')
def example():
    try:
        # Your job logic here...
        pass
    except Exception as e:
        raise RuntimeError(f"Job failed with error {str(e)}")

if __name__ == '__main__':
    client = XxlJobClient()
    client.start()

此 Python 示例展示了如何创建一个简单的作业处理器，并且如果该函数抛出了未捕获的异常，则会触发展示之前所提到过的告警机制[^4]。