Coravel Scheduler Invocable连接MySQL出现20004错误求助

1. 检查连接字符串的套接字访问权限 #

Cloud Run连接Cloud SQL（MySQL）推荐使用Unix套接字，连接字符串格式示例：

Server=/cloudsql/[PROJECT_ID]:[REGION]:[INSTANCE_NAME];Database=[DB_NAME];Uid=[USER];Pwd=[PASSWORD];

确认连接字符串使用Unix套接字而非TCP，同时在Cloud Run服务配置中已启用对应Cloud SQL实例的连接（确保/cloudsql目录被正确挂载）。若使用TCP连接，需确认Cloud SQL实例的授权网络包含Cloud Run实例的出口IP，或配置VPC连接器。

2. 增加数据库连接超时时间 #

当Coravel任务触发时，若Cloud Run实例刚从休眠状态唤醒，数据库连接建立可能需要更长时间。修改DBContext配置增加连接超时：

services.AddDbContext<ApplicationDbContext>(options =>
    options.UseMySQL(Configuration.GetConnectionString("DefaultConnection"),
        mysqlOptions => mysqlOptions.ConnectTimeout(30))); // 设置30秒连接超时

同时可在查询时添加命令超时：

var projectIds = await _dbContext.SurveySettings
    .Where(x => x.ScheduleLaunch && !x.LaunchDate.HasValue && x.ScheduleTargetDate.HasValue && x.ScheduleTargetDate.Value <= DateTime.UtcNow)
    .Select(x => x.ProjectId)
    .ToListAsync(new CancellationTokenSource(TimeSpan.FromSeconds(25)).Token);

3. 验证DBContext的生命周期配置 #

确保IApplicationDbContext以Scoped方式注册，避免Singleton带来的连接池或线程安全问题：

services.AddScoped<IApplicationDbContext, ApplicationDbContext>();

4. 调整Cloud Run实例配置 #

Cloud Run默认请求驱动，无请求时会缩容至0实例，导致Coravel调度任务触发时实例刚启动，连接数据库失败：

• 设置最小实例数为1，确保至少有一个实例持续运行，维持Coravel调度器的活跃状态。
• 配置启动探针，确认实例完全就绪（含数据库连接可用）后再运行后台任务。

5. 优化MySQL连接池参数 #

修改连接字符串调整连接池配置，避免连接耗尽或失效：

Server=/cloudsql/...;Database=...;Uid=...;Pwd=...;Max Pool Size=100;Min Pool Size=5;Connection Lifetime=1800;

• Min Pool Size：保持连接池中有最小活跃连接数，避免每次任务触发都重新创建连接。
• Connection Lifetime：设置连接最大存活时间，自动淘汰失效连接。

6. 补充详细错误日志 #

在Coravel错误处理中增加更详细的日志（隐藏敏感信息），定位错误细节：

.OnError((exception) =>
{
    var connStr = Configuration.GetConnectionString("DefaultConnection");
    var sanitizedConnStr = connStr.Replace(@"Pwd=.*?;", "Pwd=***;", StringComparison.OrdinalIgnoreCase);
    Log.Error("Coravel任务连接失败: {Exception}, 清洗后连接串: {ConnStr}", exception, sanitizedConnStr);
})

7. 手动测试任务运行环境 #

添加测试接口手动触发Coravel任务，验证错误是否与调度时机相关：

[HttpGet("test-scheduled-task")]
public async Task<IActionResult> TestTask()
{
    using var scope = _serviceScopeFactory.CreateScope();
    var invocable = scope.ServiceProvider.GetRequiredService<ProcessScheduledSurvey>();
    await invocable.Invoke();
    return Ok();
}

若手动触发也报错，说明问题出在任务代码或配置；若手动正常，则是Cloud Run实例休眠导致的触发时机问题。

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