stencil push fails with "Job Failed" / server_error during Processing (~18–21%) #1353
Description
GitHub issue for bigcommerce/stencil-cli
Copy the title and description below into: https://github.com/bigcommerce/stencil-cli/issues/new
Title
stencil push fails with "Job Failed" / server_error during Processing (~18–21%)
Description
Summary
stencil push completes validation, build, zip, and upload successfully, but the BigCommerce Processing step fails at ~18–21% with a generic server_error. No TR-* error code is returned.
Steps to reproduce
- In a Stencil theme directory, run:
stencil push - Wait for: "Theme Upload Finished"
- Processing progress reaches ~18–21%, then the job fails.
Actual result
Processing [===================== ] 21%; ETA: 9.4sError [JobCompletionStatusCheckError]: Job Failed
at Object.getJob (file:///opt/homebrew/lib/node_modules/@bigcommerce/stencil-cli/lib/theme-api-client.js:144:23)
at process.processTicksAndReject (node:internal/process/task_queues:105:5)
at async file:///opt/homebrew/lib/node_modules/@bigcommerce/stencil-cli/lib/stencil-push.utils.js:247:20 {
messages: [
{ error_code: 'server_error', message: 'A server error occurred' }
]
}
not ok -- JobCompletionStatusCheckError: Job Failed
A server error occurred
Expected result
Processing completes and the theme is available (or a specific TR-* error is returned so we can fix the theme).
Environment
- stencil-cli:
@bigcommerce/stencil-cli(global install, path:/opt/homebrew/lib/node_modules/@bigcommerce/stencil-cli) - Theme: Cornerstone-based, customizations; theme zip ~16 MB, ~1,367 files (under 50 MB limit)
- Build: Webpack bundle succeeds; asset size warnings for
theme-bundle.main.js(367 KiB) andtheme-bundle.chunk.7.js(621 KiB)
Additional context
- Tried both current theme code and an older commit; the failure is consistent in both cases.
- Troubleshooting page reviewed: https://developer.bigcommerce.com/stencil-docs/deploying-a-theme/troubleshooting-theme-uploads
- No TR-* code in the response, so it’s unclear whether this is theme validation (e.g. zip/content) or a backend/transient issue. Any way to get a more specific error code or job ID from the API would help.
Thank you.