Skip to content

[hotfix][Process] Fail and untrack processes with a missing engine - #4330

Draft
czy006 wants to merge 1 commit into
apache:masterfrom
czy006:codex/hotfix-process-missing-engine
Draft

[hotfix][Process] Fail and untrack processes with a missing engine#4330
czy006 wants to merge 1 commit into
apache:masterfrom
czy006:codex/hotfix-process-missing-engine

Conversation

@czy006

@czy006 czy006 commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Brief change log

When the configured execution engine is absent, persist the process as failed and untrack it from the table runtime. This prevents a pending process from blocking later scheduling attempts indefinitely.

How was this patch tested?

  • Validate the table-process execution path after the missing-engine handling change.
  • Add screenshots for manual tests if appropriate (not applicable: backend-only change).
  • Run TestDefaultProcessService#testRunTableProcess locally with JDK 11 before creating this pull request.

Documentation

  • Does this pull request introduce a new feature? (yes / no)
  • no
  • If yes, how is the feature documented? (not applicable / docs / JavaDocs / not documented)
  • not applicable

@github-actions github-actions Bot added the module:ams-server Ams server module label Aug 17, 2026
…missing

executeOrTraceProcess returned early when the configured execution
engine was not installed, but register() had already tracked the
PENDING process: hasAliveTableProcess then blocked this action for the
table on every scheduler tick until restart - and recovery after
restart repeated the same failure, looping forever while leaking the
tracked entry.

Persist a FAILED record with an 'Execution engine not found' message
(via the TableProcessStore interface, no cast; transition failures are
logged, never thrown) and untrack so later ticks can schedule the
action again once the engine is restored.

Regression test testMissingEngineMarksProcessFailedAndUntracks (red
before: status stayed PENDING, entry stayed tracked).
Fix record: docs/fix-records/2026-08-16-fix-16-missing-engine-stuck-process.md
@czy006
czy006 force-pushed the codex/hotfix-process-missing-engine branch from 9c037f5 to 3d03d2c Compare August 18, 2026 02:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

module:ams-server Ams server module

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant