WebView を使うアプリでは、重いページを何枚も開いたときなどに、アプリごと突然終了することがあります。
原因の 1 つが WebView の**描画プロセス(renderer)**です。Android 8.0(API 26)以降の WebView は、ページの描画や JavaScript の実行をアプリとは別のプロセスで行います。このプロセスが落ちたとき、アプリ側で何もしていないと、WebView を使っているアプリのプロセスも一緒に終了させられます。
この記事では、WebViewClient.onRenderProcessGone を使って、描画プロセスが落ちてもアプリを終了させずに立て直す方法を、実際のアプリでの使い分けとあわせてまとめます。
-
onRenderProcessGoneの基本と、trueを返したあとの約束 - ブラウザのタブ:WebView を作り直して同じページを開く
- ダイアログやプレビュー:画面を閉じて終わりにする
- 裏で動かしている WebView(WorkManager):その回を失敗として止める
- そもそも落ちにくくする:メモリが足りないときに裏のタブを解放する
前提
- 言語は Kotlin、画面は Jetpack Compose。WebView は
AndroidViewで載せています -
minSdkは 26 以上なので、onRenderProcessGoneは条件分岐なしで使えます - 1 つのアプリの中で WebView を使う場所は、ブラウザのタブのほかに、リンクのプレビュー、保存したページの表示、裏で決まった時刻にページを開く処理(WorkManager)の 4 か所あります
1. onRenderProcessGone の基本
描画プロセスが終了すると、その WebView の WebViewClient.onRenderProcessGone(view, detail) が呼ばれます。戻り値の意味は次のとおりです。
-
true:アプリ側で後始末をした。アプリのプロセスは続ける -
false(または上書きしていない):アプリのプロセスも終了させられる
つまり、上書きしていないだけで、描画プロセスのクラッシュがそのままアプリのクラッシュになります。 既定の WebViewClient を使っているアプリでも同じです。
detail.didCrash() で、落ちた理由のおおまかな区別ができます。
-
true:描画プロセスがクラッシュした -
false:システムがメモリを空けるために描画プロセスを終了させた
ただ、どちらの場合も WebView がもう使えないことに変わりはないので、私のアプリでは理由はログに残すだけにして、後始末は同じにしています。
override fun onRenderProcessGone(view: WebView, detail: RenderProcessGoneDetail): Boolean {
Log.w(TAG, "描画プロセスが終了した(crash=${detail.didCrash()})")
// ここで後始末をする(下で説明)
return true
}
true を返したら、その WebView はもう使わない
true を返すときに守ることは 1 つで、その WebView のインスタンスは二度と使わず、画面から外して destroy() することです。描画プロセスを失った WebView に loadUrl などを呼んでも、元には戻りません。続けて表示したいなら、新しい WebView を作り直す必要があります。
1 つでも受け漏らすと、そこからアプリが落ちる
描画プロセスは、同じアプリの複数の WebView で共有されることがあります。その場合、落ちたプロセスにつながっていたそれぞれの WebView で onRenderProcessGone が呼ばれます。
ここで、どれか 1 つの WebView が既定の WebViewClient のまま(false を返す)だと、ほかを全部きちんと受けていても、そこからアプリが終了します。 ブラウザのタブだけでなく、プレビュー用の小さな WebView や、裏で使っている WebView も含めて、WebView を作っているすべての場所で受ける必要があります。
タブのように目立つ場所だけに入れて、小さな WebView を忘れがちなので注意が必要です。WebView を作っている場所は WebView( や webViewClient = で検索すると洗い出せます。
2. ブラウザのタブ:作り直して同じページを開く
タブの WebView は、Compose で表示するために mutableStateOf で持たせています。WebView を作り直したときに、画面の AndroidView が新しいほうに付け替わるようにするためです。
class BrowserTab(/* … */) {
/** 状態として持つ(作り直したときに画面へ付け替えるため)。 */
var webView by mutableStateOf<WebView?>(null)
var url: String? = null
// …
}
タブの WebViewClient では、落ちたら今の URL を覚えておき、古い WebView を破棄してから、表示中のタブなら同じ URL を開き直します。
override fun onRenderProcessGone(view: WebView, detail: RenderProcessGoneDetail): Boolean {
// 描画プロセスが落ちても、アプリごと終了させない。タブを作り直して同じページを開く
Log.w(TAG, "描画プロセスが終了した(crash=${detail.didCrash()})")
val url = tab.url
destroyWebView(tab)
if (url != null && tab == current) mainHandler.post { load(tab, url) }
return true
}
破棄と読み込みは次のようになっています。load は、タブに WebView が無ければ作ってから開きます。
private fun destroyWebView(tab: BrowserTab) {
val view = tab.webView ?: return
tab.webView = null
(view.parent as? ViewGroup)?.removeView(view)
view.stopLoading()
view.destroy()
}
fun load(tab: BrowserTab, url: String) {
val view = tab.webView ?: createWebView(tab).also { tab.webView = it }
tab.url = url
view.loadUrl(url)
}
ポイントは 3 つです。
-
URL は WebView ではなく、タブ側で持っておく。 落ちたあとの WebView から
view.urlを取りに行くのではなく、doUpdateVisitedHistoryなどで自分で覚えていた値を使います -
作り直しは
Handler.postで次に回す。 コールバックの中でそのまま新しい WebView を作るのではなく、古いほうの破棄を終えてから、メインスレッドの次の処理で開き直しています - 裏のタブはその場で開き直さない。 描画プロセスが共有されていると、裏のタブにも同時にコールバックが来ます。全部をその場で読み込み直すと、メモリが足りなくて落ちた直後にまた重くなるので、表示中のタブだけを開き直します
裏のタブは、選ばれたときに開き直す
裏のタブは WebView を破棄したまま、url だけが残った状態になります。そこで、タブを選んだときに「WebView が無くて URL がある」なら読み込み直すようにしています。
fun select(index: Int) {
// …
selectedIndex = index
val tab = tabs[index]
if (tab.webView == null && tab.url != null) load(tab, tab.url!!)
tab.webView?.onResume()
}
この「WebView は無いが URL は覚えている」状態は、あとで説明するメモリ不足のときの解放でも使っています。タブの状態を WebView の外に持っておくと、WebView をいつ捨てても困らない作りになります。
なお、作り直したタブでは、戻る・進むの履歴は失われます(新しい WebView で URL を開き直すだけなので)。入力中のフォームの内容なども戻りません。ここは割り切っています。
3. ダイアログやプレビュー:閉じて終わりにする
リンクを長押ししたときのプレビューは、Compose の Dialog の中に WebView を出しています。ここでは作り直しはせず、ダイアログを閉じるだけにしました。
webViewClient = object : WebViewClient() {
// 描画プロセスが落ちても、アプリごと終了させない(プレビューを閉じる)
override fun onRenderProcessGone(view: WebView, detail: RenderProcessGoneDetail): Boolean {
onDismiss()
return true
}
}
WebView の破棄は、ダイアログが閉じたときの DisposableEffect に任せています。閉じ方(利用者が閉じた・落ちて閉じた)にかかわらず、破棄の処理を 1 か所にまとめられます。
DisposableEffect(webView) {
onDispose {
webView.stopLoading()
webView.destroy()
}
}
保存したページを表示する画面(AndroidView で全画面に出しているもの)では、WebView を親から外して破棄します。表示は消えますが、アプリは落ちません。
override fun onRenderProcessGone(view: WebView, detail: RenderProcessGoneDetail): Boolean {
(view.parent as? ViewGroup)?.removeView(view)
view.destroy()
return true
}
プレビューのような補助的な画面では、無理に復旧しないのが単純で安全です。利用者はもう一度開けば済みます。
4. 裏で動かす WebView:その回を失敗にする
このアプリには、決まった時刻にページを開いて、内容を確かめて通知する機能があります。WorkManager の CoroutineWorker の中で、画面に出さない WebView を作って動かしています。
ここで描画プロセスが落ちても、アプリのプロセスごと終了されると、利用者が画面で使っているブラウザまで巻き込まれます。 そこで、フラグを立てて、その回の処理を失敗として止めるようにしました。
var loading = false
var rendererGone = false
view.webViewClient = object : WebViewClient() {
override fun onPageStarted(v: WebView, url: String, favicon: Bitmap?) { loading = true }
override fun onPageFinished(v: WebView, url: String) { loading = false }
// 描画プロセスが落ちても(メモリ不足など)、アプリごと終了させない。この回は失敗として止める
override fun onRenderProcessGone(v: WebView, detail: RenderProcessGoneDetail): Boolean {
Log.w(TAG, "定期実行中に描画プロセスが終了した(crash=${detail.didCrash()})")
rendererGone = true
loading = false // 「読み込み中」のまま待ち続けないように
return true
}
}
処理の終わりを待つループでも、このフラグを見ます。
val finished = withTimeoutOrNull(TIMEOUT_MS) {
while (runner.running != null && !rendererGone) delay(300)
} != null && !rendererGone
後始末では、描画プロセスが落ちた WebView には stopLoading() を呼ばず、destroy() だけにしています。
} finally {
// 描画プロセスが落ちた WebView は、もう使えないので止めずに破棄だけする
if (!rendererGone) view.stopLoading()
view.destroy()
scope.cancel()
}
最後に、失敗した回は Result.retry() を返して、WorkManager にやり直しを任せています。
val ok = withContext(Dispatchers.Main) { runHeadless(workflow) }
return if (ok) Result.success() else Result.retry()
裏の処理で気をつけたいのは、「読み込み中」や「終わるまで待つ」の状態が、コールバックが来ないまま残らないようにすることです。描画プロセスが落ちると onPageFinished は来ないので、フラグを落とさないと、タイムアウトまで無駄に待つことになります。
5. そもそも落ちにくくする:メモリが足りないときに裏のタブを解放する
didCrash() が false のとき、つまりシステムがメモリを空けるために描画プロセスを終了させたときは、アプリ側でメモリを減らしておくことで起きにくくできます。
このアプリでは、Activity.onTrimMemory でメモリが足りなくなってきたことを受けたら、表示していないタブの WebView を解放しています。
override fun onTrimMemory(level: Int) {
super.onTrimMemory(level)
@Suppress("DEPRECATION")
if (level >= ComponentCallbacks2.TRIM_MEMORY_RUNNING_LOW || level == ComponentCallbacks2.TRIM_MEMORY_BACKGROUND) {
val count = tabs.discardBackgroundTabs()
if (count > 0) Log.i(TAG, "メモリ不足のため、裏のタブ $count 個の WebView を解放した")
}
}
/**
* 表示していない通常のタブの WebView を解放する(URL とタイトルは残し、選び直したら読み込み直す)。
* プライベートタブはログイン状態などが失われるので解放しない。
*/
fun discardBackgroundTabs(): Int {
val selected = current
var count = 0
tabs.filter { it !== selected && !it.isPrivate && it.webView != null && it.url != null }.forEach { tab ->
destroyWebView(tab)
tab.isLoading = false
count++
}
return count
}
解放したタブは、2 節と同じく「WebView は無いが URL はある」状態になるので、選んだときに読み込み直されます。描画プロセスが落ちたときの復旧と、メモリ不足での解放が、同じ仕組みで済むのがこの作りのよいところです。
プライベートタブを対象から外しているのは、WebView を捨てるとログイン状態などが失われてしまうからです。URL だけ残して読み込み直しても、元の状態には戻りません。
まとめ
-
onRenderProcessGoneを上書きしていない WebView が 1 つでもあると、描画プロセスのクラッシュがアプリのクラッシュになる。WebView を作るすべての場所で受ける -
trueを返したら、その WebView は画面から外してdestroy()。続けて表示するなら作り直す - タブの URL などの状態は WebView の外に持つと、作り直しやメモリ不足での解放が楽になる
- プレビューなどの補助的な画面は、閉じて終わりが単純で安全
- 裏で動かす WebView では、待ち状態のフラグを落として、その回を失敗にする
-
onTrimMemoryで裏のタブを解放して、そもそも落ちにくくする
おまけ:この作りを入れたブラウザ
この記事の WebView の扱いは、個人で開発している Android 向けのブラウザ Orbiel(オルビエル) に入っています。AI による要約・翻訳・質問(API キーは自分のものを使う BYOK 方式)と、広告ブロックをひとつにまとめたブラウザで、2026 年 11 月下旬に Google Play で公開する予定です。
「このページを開くと落ちる」といった情報をいただけると、とても助かります。