vercel/next.js · error
Sending SIGTERM signal to static worker due to timeout${time
Error message
Sending SIGTERM signal to static worker due to timeout${timeout ? ` of ${timeout / 1000} seconds` : ''}. Subsequent errors may be a result of the worker exiting. What it means
The worker wrapper's onHanging callback fires when a static worker shows no activity for the configured timeout; it sends SIGTERM to the stalled worker, recreates it (retrying the task), and warns that any subsequent errors likely stem from the terminated worker rather than the task itself.
Source
Thrown at packages/next/src/lib/worker.ts:233
callback()
},
})
// Stop the activity if there's any output from the worker
this._worker.getStdout().pipe(abortActivityStreamOnLog)
this._worker.getStderr().pipe(abortActivityStreamOnLog)
// Pipe the worker's stdout and stderr to the parent process
this._worker.getStdout().pipe(process.stdout)
this._worker.getStderr().pipe(process.stderr)
}
createWorker()
const onHanging = () => {
const worker = this._worker
if (!worker) return
const resolve = resolveRestartPromise
createWorker()
logger.warn(
`Sending SIGTERM signal to static worker due to timeout${
timeout ? ` of ${timeout / 1000} seconds` : ''
}. Subsequent errors may be a result of the worker exiting.`
)
worker.end().then(() => {
resolve(RESTARTED)
})
}
let hangingTimer: NodeJS.Timeout | false = false
const onActivityImpl = () => {
if (hangingTimer) clearTimeout(hangingTimer)
if (this._onActivity) this._onActivity()
hangingTimer = activeTasks > 0 && setTimeout(onHanging, timeout)
}
View on GitHub (pinned to 0eb3775416)
Solutions
- Investigate why the static worker hung (slow getStaticProps, infinite loops); increase the static generation timeout if needed.
Defensive patterns
Strategy: retry
When it happens
Trigger: Thrown at packages/next/src/lib/worker.ts:233 when the library encounters an invalid state.
Common situations: See trigger scenarios.
Understand the failure class
- Timeouts: ETIMEDOUT, deadlines, and hung requests — what actually expires when a request times out.
AI-assisted analysis of vercel/next.js@0eb3775416 (2026-08-19).
Data as JSON: /api/errors/f709d27e6796c99e.
Report an issue: GitHub.