Bolt api

Long-Running Job Timeout - Background Tasks Interrupted

Long-running operations (file processing, email sending, bulk updates) timeout. Tasks don't complete.

Operations that take >30 seconds fail on serverless deployments.

Error Messages You Might See

Operation timeout after 60 seconds Function execution terminated Task interrupted by timeout Job never completed
Operation timeout after 60 secondsFunction execution terminatedTask interrupted by timeoutJob never completed

Common Causes

  1. Running long task synchronously in API route
  2. Serverless timeout shorter than task duration
  3. No background job queue (Bull, RabbitMQ)
  4. Task killed before cleanup code runs
  5. No retry mechanism for failed jobs

How to Fix It

Use background job queue: Bull, RabbitMQ, or cloud services (Google Tasks, AWS SQS)

Pattern: API returns immediately with job ID, frontend polls for status

Implement retry logic with exponential backoff

Add timeout to job: if not complete in 5 min, mark failed and retry

Process jobs outside request context: cron job, worker service, or queue consumer

Real developers can help you.

Richard McSorley Richard McSorley Full-Stack Software Engineer with 8+ years building high-performance applications for enterprise clients. Shipped production systems at Walmart (4,000+ stores), Cigna (20M+ users), and Arkansas Blue Cross. 5 patents in retail/supply chain tech. Currently focused on AI integrations, automation tools, and TypeScript-first architectures. Tejas Chokhawala Tejas Chokhawala Full-stack engineer with 5 years experience building production web apps using React, Next.js and TypeScript. Focused on performance, clean architecture and shipping fast. Experienced with Supabase/Postgres backends, Stripe billing, and building AI-assisted developer tools. Antriksh Narang Antriksh Narang 5 years+ Experienced Dev (Specially in Web Development), can help in python, javascript, react, next.js and full stack web dev technologies. Jen Jacobsen Jen Jacobsen I’m a Full-Stack Developer with over 10 years of experience building modern web and mobile applications. I enjoy working across the full product lifecycle — turning ideas into real, well-built products that are intuitive for users and scalable for businesses. I particularly enjoy building mobile apps, modern web platforms, and solving complex technical problems in a way that keeps systems clean, reliable, and easy to maintain. Nam Tran Nam Tran 10 years as fullstack developer Bastien Labelle Bastien Labelle Full stack dev w/ 20+ years of experience Matthew Butler Matthew Butler Systems Development Engineer @ Amazon Web Services Matt Butler Matt Butler Software Engineer @ AWS MFox MFox Full-stack professional senior engineer (15+years). Extensive experience in software development, qa, and IP networking. Krishna Sai Kuncha Krishna Sai Kuncha Experienced Professional Full stack Developer with 8+ years of experience across react, python, js, ts, golang and react-native. Developed inhouse websearch tooling for AI before websearch was solved : )

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help

Frequently Asked Questions

How do I handle long tasks?

Queue the job, return immediately with ID. Frontend polls /api/job/id for status

What's a good job timeout?

Set longer than expected: if usually 2min, set 5min timeout. Prevents premature kills

Should I retry failed jobs?

Yes. Retry with exponential backoff: 1min, 5min, 30min. Max 3-5 retries

Related Bolt Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help