WebView 화면을 여러 번 열고 닫을수록 앱이 무거워질 때 확인할 것들을 정리했습니다. Activity 참조가 남는 원인, destroy() 호출 순서, JavaScript 인터페이스 정리, 렌더러 프로세스 종료 처리, 별도 프로세스로 분리할 때 주의점까지 다룹니다.
WebView 화면을 열고 닫는 걸 몇 번 반복하면 앱이 눈에 띄게 무거워지는 경우가 있습니다. 메모리 프로파일러를 보면 화면을 닫을 때마다 힙이 조금씩 늘고 줄지 않습니다. 원인은 거의 항상 닫힌 Activity나 Fragment가 WebView를 통해 어딘가에 붙잡혀 있는 것입니다.
WebView는 크롬 엔진을 품고 있어서 객체 하나가 차지하는 메모리가 큽니다. 일반 View가 새는 것보다 피해가 훨씬 빨리 드러나는 이유입니다. 이 글은 누수를 확인하는 방법과, 해제 코드를 어떤 순서로 짜야 하는지 정리한 것입니다.
누수 참조 경로
누수부터 확인하기
감으로 고치기 전에 실제로 무엇이 남는지 확인합니다. 가장 빠른 방법은 디버그 빌드에 LeakCanary를 넣는 것입니다. 화면을 닫은 뒤 5초 안에 Activity나 Fragment가 회수되지 않으면 참조 경로를 알림으로 보여 줍니다.
KOTLIN
// app/build.gradle.kts, 디버그 빌드에만 추가
dependencies {
debugImplementation("com.squareup.leakcanary:leakcanary-android:2.14")
}
Android Studio의 Memory Profiler로도 확인할 수 있습니다. WebView 화면을 다섯 번쯤 열고 닫은 뒤 힙 덤프를 받아서, 클래스 목록에서 해당 Activity나 Fragment를 검색합니다. 화면이 닫혀 있는데 인스턴스가 여러 개 남아 있으면 누수입니다.
logcat의 GC 로그는 보조 지표로만 봅니다. 앱이 System.gc()를 직접 부르지 않는 한 Explicit concurrent GC는 잘 찍히지 않고, GC가 자주 돈다는 사실만으로는 무엇이 새는지 알 수 없습니다.
BASH
# 앱 프로세스의 메모리 요약 (Java 힙, Native 힙, 전체 PSS)
adb shell dumpsys meminfo com.example.app
dumpsys meminfo의 Objects 항목에 Activities와 WebViews 개수가 나옵니다. 화면을 다 닫았는데 이 숫자가 0으로 돌아오지 않으면 그 자체로 누수 신호입니다.
왜 WebView에서 유독 많이 새나
레이아웃 XML로 만든 WebView는 생성할 때 Activity를 Context로 받습니다. 그래서 WebView를 누군가 붙잡고 있으면 Activity 전체가 같이 남습니다. 흔한 경로는 다음과 같습니다.
addJavascriptInterface()로 넘긴 객체가 Activity나 Fragment를 참조하는 경우
WebViewClient, WebChromeClient를 익명 내부 클래스로 만들어 바깥 Fragment를 암묵적으로 참조하는 경우
비동기 콜백(evaluateJavascript 결과, 네트워크 응답)이 화면이 닫힌 뒤에 WebView를 건드리는 경우
Fragment 필드에 WebView를 들고 있으면서 onDestroyView()에서 null로 바꾸지 않는 경우
마지막 경우가 특히 많습니다. Fragment는 백스택에 들어가면 뷰만 사라지고 인스턴스는 살아 있습니다. 필드에 WebView 참조가 남아 있으면 이미 화면에서 떨어진 WebView와 그 안의 페이지 전체가 계속 메모리에 남습니다.
해제 코드는 순서가 중요하다
WebView를 정리할 때는 부모 뷰에서 떼고, 로딩과 스크립트를 멈추고, 마지막에 destroy()를 부릅니다. 공식 문서도 destroy()는 WebView를 뷰 계층에서 제거한 뒤에 호출하라고 안내합니다.
KOTLIN
classWebViewFragment : Fragment(R.layout.fragment_webview) {
privatevar webView: WebView? = nulloverridefunonViewCreated(view: View, savedInstanceState: Bundle?) {
webView = view.findViewById<WebView>(R.id.web_view).apply {
settings.javaScriptEnabled = true
webViewClient = AppWebViewClient() // 바깥 참조 없는 별도 클래스
addJavascriptInterface(Bridge(), "Android") // Bridge도 Fragment를 직접 참조하지 않게
loadUrl("https://www.example.com")
}
}
overridefunonDestroyView() {
webView?.let { wv ->
(wv.parent as? ViewGroup)?.removeView(wv) // 1. 뷰 계층에서 분리
wv.stopLoading() // 2. 진행 중인 로딩 중단
wv.removeJavascriptInterface("Android") // 3. JS 브리지 정리
wv.webChromeClient = null
wv.destroy() // 4. 내부 리소스 해제
}
webView = null// 5. 필드 참조 끊기super.onDestroyView()
}
}
Activity라면 같은 코드를 onDestroy()에 둡니다. destroy()를 부른 뒤에는 그 WebView의 어떤 메서드도 호출하면 안 되니, 비동기 콜백에서는 화면이 살아 있는지(isAdded, lifecycle.currentState)부터 확인하게 만듭니다.
shouldOverrideUrlLoading에서 view.loadUrl()을 직접 부르고 true를 돌려주는 코드도 자주 보입니다. 같은 WebView에서 열 거라면 false만 돌려주면 됩니다. 직접 다시 로드하면 리다이렉트 기록이 꼬이고 불필요한 로딩이 한 번 더 생깁니다.
Android 8.0부터 WebView의 렌더러는 앱과 다른 프로세스에서 돕니다. 메모리가 부족하면 시스템이 이 렌더러 프로세스를 먼저 죽이는데, 앱이 이를 처리하지 않으면 앱 프로세스도 같이 종료됩니다. 사용자는 "앱이 갑자기 꺼졌다"고 느끼고, 크래시 리포트에는 원인이 잘 안 남습니다.
onRenderProcessGone()을 구현하면 해당 WebView만 정리하고 앱은 살릴 수 있습니다.
KOTLIN
overridefunonRenderProcessGone(
view: WebView, detail: RenderProcessGoneDetail
): Boolean {
// 죽은 렌더러에 붙어 있던 WebView는 다시 쓸 수 없으므로 제거
(view.parent as? ViewGroup)?.removeView(view)
view.destroy()
// 필요하면 새 WebView를 만들어 다시 로드하거나 에러 화면 표시returntrue// true를 돌려줘야 앱 프로세스가 유지됨
}
detail.didCrash()가 false면 메모리 회수 때문에 시스템이 죽인 경우입니다. 이 비율이 높다면 페이지 자체가 무겁다는 신호이니 웹 쪽 최적화도 같이 봐야 합니다.
WebView를 별도 프로세스로 분리할 때
WebView 화면이 특히 무겁다면 그 Activity를 별도 프로세스로 띄우는 방법이 있습니다. 화면을 닫고 프로세스를 정리하면 메모리가 확실히 돌아옵니다.
다만 Android 9(API 28)부터는 같은 앱의 여러 프로세스가 같은 WebView 데이터 디렉터리를 동시에 쓰면 예외가 납니다. 메인 프로세스에서도 WebView를 쓴다면, 별도 프로세스에서는 WebView를 처음 만들기 전에 디렉터리 접미사를 지정해야 합니다.
KOTLIN
classApp : Application() {
overridefunonCreate() {
super.onCreate()
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
val name = Application.getProcessName()
if (name != packageName) {
// ":web" 프로세스는 자기만의 쿠키·캐시 디렉터리를 씀
WebView.setDataDirectorySuffix(name.substringAfter(':'))
}
}
}
}
데이터 디렉터리가 나뉘면 쿠키와 로그인 상태도 공유되지 않습니다. 로그인 세션을 WebView 쿠키로 유지하는 앱이라면 이 방식이 맞는지 먼저 따져 봐야 합니다. 프로세스 사이에서는 싱글턴이나 메모리 캐시도 공유되지 않습니다.
자주 받는 질문
Q. destroy()까지 했는데 프로파일러에 WebView 객체가 남아 있습니다.
destroy() 직후에는 GC가 아직 안 돌았을 수 있으니, 프로파일러에서 GC를 강제로 한 번 돌린 뒤 다시 봅니다. 그래도 남아 있다면 힙 덤프에서 해당 객체의 참조 경로(Path to GC root)를 확인합니다. 대부분 정적 필드, 싱글턴, 아직 끝나지 않은 콜백 중 하나가 붙잡고 있습니다.
Q. freeMemory()나 clearCache()로 메모리를 줄일 수 있나요?
freeMemory()는 API 19에서 폐기됐고 지금은 아무 효과가 없습니다. clearCache(true)는 디스크 캐시까지 지우는 기능이라 메모리 누수와는 관계가 없고, 다음 방문 때 리소스를 다시 받아야 해서 오히려 느려집니다.
Q. WebView를 미리 만들어 두고 재사용하면 빨라지지 않나요?
첫 로딩 시간은 줄어듭니다. 대신 재사용하는 WebView는 Activity가 아닌 MutableContextWrapper 같은 래퍼로 만들고, 붙을 때마다 Context를 바꿔 줘야 이전 Activity를 붙잡지 않습니다. 이전 페이지의 JavaScript 상태와 히스토리도 직접 정리해야 해서 관리 비용이 큽니다. 성능 측정으로 확실한 이득이 확인될 때만 쓰는 편이 낫습니다.
Q. Application Context로 WebView를 만들면 누수가 없지 않나요?
Activity 누수는 막을 수 있지만, 그 WebView에서 <select> 팝업, 파일 선택, 권한 대화상자처럼 Activity가 필요한 기능이 제대로 동작하지 않습니다. 해제 순서를 지키고 참조를 끊는 쪽이 부작용이 적습니다.