ASP.NET中用HangFire实现每小时自动调用邮件提醒方法咨询

Hey, 用HangFire完全能解决你的需求，而且它是基于应用内的任务调度，不需要系统级权限（完美符合你没有服务器权限的情况）。下面给你一步步的实现方案，还会补充一些最佳实践：

1. 安装必要的NuGet包 #

首先在你的ASP.NET Core项目中安装HangFire核心包和存储包（这里以SQL Server为例，你也可以用Redis等其他持久化存储）：

Install-Package HangFire.AspNetCore
Install-Package HangFire.SqlServer

2. 配置HangFire到应用中 #

在Program.cs里添加HangFire的服务配置和中间件：

var builder = WebApplication.CreateBuilder(args);

// 注册HangFire服务，使用SQL Server存储（替换成你的数据库连接字符串）
builder.Services.AddHangfire(configuration => configuration
    .UseSqlServerStorage(builder.Configuration.GetConnectionString("DefaultConnection")));

// 注册HangFire后台执行服务
builder.Services.AddHangfireServer();

// 注册你的仓储和新的提醒服务（后面会说明为什么要抽成独立服务）
builder.Services.AddScoped<IEventRepository, EventRepository>();
builder.Services.AddScoped<IUserRepository, UserRepository>();
builder.Services.AddScoped<IEventReminderService, EventReminderService>();

var app = builder.Build();

// 启用HangFire仪表盘（可选，用于查看任务执行状态、重试记录等）
app.UseHangfireDashboard("/hangfire", new DashboardOptions
{
    // 建议添加授权过滤，避免未授权用户访问
    Authorization = new[] { new HangFireAdminAuthorizationFilter() }
});

// 应用启动后注册定时任务
app.Lifetime.ApplicationStarted.Register(() =>
{
    using var scope = app.Services.CreateScope();
    var recurringJobManager = scope.ServiceProvider.GetRequiredService<IRecurringJobManager>();
    
    // 配置每整点执行的任务
    recurringJobManager.AddOrUpdate<IEventReminderService>(
        "hourly-event-reminder", // 任务唯一标识，用于后续更新或删除任务
        service => service.SendHourlyReminders(),
        Cron.Hourly); // Cron表达式：代表每整点执行一次
});

// 其他中间件配置（如路由、身份验证等）...
app.Run();

3. 将邮件提醒逻辑抽成独立服务（最佳实践） #

直接调用控制器方法可能会遇到依赖注入的问题，建议把你的EventReminder逻辑移到一个独立的服务类中，更符合ASP.NET Core的设计原则：

定义服务接口 #

public interface IEventReminderService
{
    Task SendHourlyReminders();
}

实现服务类 #

public class EventReminderService : IEventReminderService
{
    private readonly IEventRepository _eventRepository;
    private readonly IUserRepository _userRepository;

    public EventReminderService(IEventRepository eventRepository, IUserRepository userRepository)
    {
        _eventRepository = eventRepository;
        _userRepository = userRepository;
    }

    public async Task SendHourlyReminders()
    {
        var currentTime = DateTime.Now;
        var upcomingEvents = _eventRepository.GetEventsByDateTimeNow();
        
        foreach (var evnt in upcomingEvents)
        {
            var attendee = _userRepository.GetUserById(evnt.AttendeeId);
            if (attendee == null || string.IsNullOrEmpty(attendee.Email))
                continue; // 跳过无有效邮箱的用户

            var message = new MimeMessage();
            message.From.Add(new MailboxAddress("你的应用名称", "your-official-email@gmail.com"));
            message.To.Add(new MailboxAddress(attendee.Name, attendee.Email));
            message.Subject = "预约即将开始提醒";
            message.Body = new TextPart("html") 
            { 
                Text = $"您好！您的预约「{evnt.Title}」将在1小时后开始，请做好准备。" 
            };

            using (var client = new SmtpClient())
            {
                // Gmail注意：必须启用两步验证，使用「应用密码」替代原账号密码，否则会被Google拦截
                await client.ConnectAsync("smtp.gmail.com", 587, false);
                await client.AuthenticateAsync("your-official-email@gmail.com", "your-app-specific-password");
                await client.SendAsync(message);
                await client.DisconnectAsync(true);
            }
        }
    }
}

自定义仪表盘授权过滤器（可选但推荐） #

如果要开放HangFire仪表盘，一定要添加权限控制，避免陌生人访问：

public class HangFireAdminAuthorizationFilter : IDashboardAuthorizationFilter
{
    public bool Authorize(DashboardContext context)
    {
        var httpContext = context.GetHttpContext();
        // 这里可以根据你的身份验证逻辑调整，比如只允许管理员角色访问
        return httpContext.User.Identity.IsAuthenticated && 
               httpContext.User.IsInRole("Admin");
    }
}

4. 关键注意事项 #

• Gmail SMTP配置：必须启用两步验证，然后生成「应用密码」来替代原账号密码，否则Google会拒绝登录请求。
• HangFire存储：生产环境绝对不要用默认的内存存储（应用重启后任务会全部丢失），一定要用SQL Server/Redis等持久化存储。
• 任务容错：HangFire会自动重试失败的任务，你也可以通过配置自定义重试次数、间隔和失败处理逻辑。

替代方案：Quartz.NET #

如果不想用HangFire，Quartz.NET也是一个成熟的任务调度框架，配置稍复杂但功能更灵活。不过对于你的整点调度需求，HangFire的Cron.Hourly已经足够简单易用。

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