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

  1. 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


AI-assisted analysis of vercel/next.js@0eb3775416 (2026-08-19). Data as JSON: /api/errors/f709d27e6796c99e. Report an issue: GitHub.