alibaba/arthas · error · IllegalStateException

Cannot set to background a process in {} state

Error message

Cannot set to background a process in {} state

What it means

Thrown by Process.toBackground() when the process is not in the RUNNING state. Moving a process to background is only valid while it is actively running in the foreground; calling it on a READY, STOPPED, or TERMINATED process is a state error.

Source

Thrown at core/src/main/java/com/taobao/arthas/core/shell/system/impl/ProcessImpl.java:216

            }
        } else {
            throw new IllegalStateException("Cannot suspend process in " + processStatus + " state");
        }
    }

    @Override
    public void toBackground() {
        toBackground(null);
    }

    @Override
    public void toBackground(Handler<Void> completionHandler) {
        if (processStatus == ExecStatus.RUNNING) {
            if (processForeground) {
                updateStatus(ExecStatus.RUNNING, null, false, backgroundHandler, terminatedHandler, completionHandler);
            }
        } else {
            throw new IllegalStateException("Cannot set to background a process in " + processStatus + " state");
        }
    }

    @Override
    public void toForeground() {
        toForeground(null);
    }

    @Override
    public void toForeground(Handler<Void> completionHandler) {
        if (processStatus == ExecStatus.RUNNING) {
            if (!processForeground) {
                updateStatus(ExecStatus.RUNNING, null, true, foregroundHandler, terminatedHandler, completionHandler);
            }
        } else {
            throw new IllegalStateException("Cannot set to foreground a process in " + processStatus + " state");
        }
    }

View on GitHub (pinned to 21cf2e9ba5)

Solutions

1. Check job status with 'jobs'; only background a RUNNING job.
2. If the job is STOPPED, resume it first (it will run in foreground) then move to background.

Example fix

// before
job.process().toBackground();

// after
if (job.process().status() == ExecStatus.RUNNING) {
    job.process().toBackground();
}

if (process.status() == ExecStatus.RUNNING) {
    process.toBackground();
}

boolean canBackground(Process p) {
    return p.status() == ExecStatus.RUNNING;
}

try {
    process.toBackground();
} catch (IllegalStateException e) {
    if (e.getMessage().contains("Cannot set to background")) {
        // not running; no-op
    }
}

When it happens

Trigger: Issuing the 'bg <jobId>' command on a job that is not currently running (e.g. it is stopped or already terminated).

Common situations: User backgrounds a job that was already suspended (must resume first) or that has completed.

Related errors

• Cannot interrupt process in {} state
• Cannot resume process in {} state
• Cannot suspend process in {} state
• Cannot set to foreground a process in {} state
• Cannot terminate terminated process

AI-assisted analysis of alibaba/arthas@21cf2e9ba5 (2026-08-14). Data as JSON: /api/errors/e9e4a88f809157e6. Report an issue: GitHub.