wordpress-mobile / wordpress-mobile/GutenbergKit
Android: a WebView renderer crash kills the host app process
@dcalhoun is already working on this.
Since Sep 9, 2026.
- Dominant language
- JavaScript
- Stars
- 29
- Forks
- 6
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
Description
GutenbergView never overrides WebViewClient.onRenderProcessGone. When Android's WebView renderer process dies, the default behaviour is to kill the process hosting the WebView — so a renderer crash inside the editor takes the whole app down rather than just the editor.
iOS handles the equivalent case: controllerWebContentProcessDidTerminate resets readiness and reloads the web view, so the editor recovers in place.
$ grep -rn "onRenderProcessGone\|RenderProcessGoneDetail" android/Gutenberg/src/main/java/org/wordpress/gutenberg/
(no matches)
This is separate from the editor's JavaScript ErrorBoundary crash, which is handled in #638, #640 and #642. Those cover a React error that unmounts the editor while the renderer stays alive. This issue is the renderer process itself dying — out-of-memory being the most common cause on lower-end devices.
Step-by-step reproduction instructions
- Open the editor in the demo app or WordPress-Android.
- Terminate the renderer process for the editor's WebView. Either:
adb shell am kill <renderer process>— the sandboxed renderer appears as a child process of the app, or- navigate the WebView to
chrome://crashfromchrome://inspect.
- Observe the app process dies rather than the editor recovering.
Expected: the editor recovers, or at minimum reports an unusable editor to the host without terminating the app.
Suggested fix
Override onRenderProcessGone on the WebViewClient, return true to signal the crash was handled, and reuse the recovery path added in #642:
override fun onRenderProcessGone(view: WebView?, detail: RenderProcessGoneDetail?): Boolean {
isEditorLoaded = false
reloadEditor()
return true
}
Returning true is what prevents Android from killing the process. Note the WebView whose renderer died cannot be reused for rendering in all cases, so this may require recreating the WebView rather than reloading it — worth verifying against detail.didCrash() to distinguish a genuine crash from the system reclaiming memory.
Content recovery comes for free through LatestContentProvider, the same path reloadEditor() already uses.
Environment info
- GutenbergKit
trunk - Android — all versions;
onRenderProcessGoneis available from API 26 and the module'sminSdkis above that.
🤖 Generated with Claude Code
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.