이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.

728x90
반응형
SMALL

애드몹 하단 배너가 특정 상황에서 통째로 안 뜨고 빈 자리로만 남아 있었습니다. 8월에 배너 요청 폭을 화면 전체 폭에서 실제로 놓이는 자리의 폭으로 바꾸고 실기기에서 실패 0건을 확인했는데, 두 달 뒤 GA4 전수를 보니 고친 뒤의 버전에서 같은 실패가 두 번 더 나 있었습니다. 남은 실패는 전부 가로 방향이었고, 구버전 안드로이드의 광고 SDK가 카메라 구멍(디스플레이 컷아웃) 자리를 화면 폭에서 빼고 보기 때문이었습니다. 세로로만 테스트하면 영영 걸리지 않는 경우라, 숫자로 방향을 알아낸 방법과 에뮬레이터 재현, 고친 코드를 정리합니다.

증상 — 화면에는 빈 자리, 로그에는 code=1

제 앱들은 하단에 적응형 배너(Anchored Adaptive Banner)를 하나씩 둡니다. 배너가 안 뜰 때 사용자 화면에는 그냥 비어 있는 띠만 보이고, 크래시도 경고도 없습니다. 처음에는 배너에 AdListener조차 없어서 왜 안 뜨는지 알 방법이 아예 없었고, 8월에 실패 계측을 붙이고 나서야 이런 기록이 잡혔습니다.

code=1 Error building request URL: Ad size will not fit on screen.
       a_w=882, a_h=62, s_w=809

오류 코드 1은 요청 자체가 잘못됐다는 뜻(ERROR_CODE_INVALID_REQUEST)이라, 재고 없음(3)이나 네트워크(2)와 달리 몇 번을 다시 받아도 결과가 같습니다. 앞의 a_w는 요청한 광고 폭, s_w는 SDK가 화면이라고 본 폭(dp)으로, 화면보다 넓은 광고를 달라고 해서 거절당한 것입니다. 이 첫 기록은 칼로리 기록 앱의 갤럭시 노트20 울트라(SM-N986N)에서 나왔습니다.

1차 수정 — 화면 폭 대신 놓일 자리의 폭

당시 배너는 LocalConfiguration.current.screenWidthDp로 폭을 정하고 있었습니다. 이 값은 앱 창 전체의 폭이라 배너가 실제로 놓이는 자리보다 넓게 나올 수 있습니다. 그래서 부모가 준 제약을 쓰도록 바꿨습니다. 아래는 성경 앱의 8월 23일 수정입니다(실제 코드, 일부).

@Composable
fun AdBanner(modifier: Modifier = Modifier) = BoxWithConstraints(modifier) {
    // 앱 창 전체 폭(screenWidthDp)을 쓰면 놓일 자리보다 넓게 요청돼
    // code=1 Ad size will not fit on screen 으로 거절된다.
    val adWidthDp = maxWidth
    AndroidView(
        factory = { context ->
            AdView(context).apply {
                setAdSize(
                    // 제약이 무한이면 폭을 알 수 없으니 고정 크기로 물러선다.
                    if (adWidthDp.value.isFinite() && adWidthDp > 0.dp)
                        AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
                            context, adWidthDp.value.toInt()
                        )
                    else AdSize.BANNER
                )
                // ... adUnitId, adListener, loadAd
            }
        },
        modifier = Modifier.fillMaxWidth()
    )
}

Dp에는 isFinite가 없어서 dp.value.isFinite()로 무한을 따로 걸러야 한다는 것도 이때 알았습니다. 릴리스 빌드를 실기기에 깔아 배너가 실제로 채워지고 will not fit이 0건인 것을 확인했고, 그걸로 끝난 줄 알았습니다.

원인 — 남은 실패는 전부 가로 방향이었다

10월 12일, GA4에 쌓인 60일치 배너 실패를 전수로 다시 보다가 1차 수정 이후 버전에서 같은 문구를 두 건 더 찾았습니다.

날짜앱 버전기기기록초과분
8/22칼로리 앱 1.2.3 (수정 전)SM-N986Na_w=882 a_h=62 s_w=80973dp
9/20성경 앱 1.0.17 (수정 후)moto g62 5Ga_w=732 a_h=53 s_w=69537dp
10/11성경 앱 1.0.25 (수정 후)SM-A315Na_w=866 a_h=62 s_w=83729dp

실마리는 a_h, 즉 광고 높이였습니다. 적응형 배너 높이는 대략 화면 높이(dp)의 15% 언저리로 정해진다고 보고 거꾸로 계산하면, a_h=62는 화면 높이 약 413dp, a_h=53은 약 353dp입니다. 폰을 세로로 들면 화면 높이가 800-900dp는 되니, 세 건 모두 가로 방향이었다는 뜻입니다. 8월에 본 "0건"은 세로로 든 기기 한 대에서 확인한 것이었습니다.

그 화면에서 배너를 감싼 Column에는 이미 navigationBarsPadding()이 있어서, 가로 모드에서 옆으로 가는 내비게이션 바 폭은 빠진 상태였습니다. 그런데도 29-37dp가 더 넓었습니다. 남은 후보는 가로에서 옆으로 오는 카메라 구멍이었습니다. enableEdgeToEdge()로 띄운 창은 컷아웃 자리까지 차지하는데, SDK가 보는 화면 폭은 그 자리를 뺀 값이라면 숫자가 맞습니다.

제 폰으로는 재현이 안 됐다
제 테스트 기기는 갤럭시 노트9(SM-N960N)인데, 펀치홀이 없는 기기라 가로로 돌려도 이 경로에 들어가지 않습니다. 실패 기록이 나온 세 기기는 전부 화면에 카메라 구멍이 있는 기종입니다. 그래서 컷아웃이 원인이라는 것은 기기 재현 전까지는 추정이었습니다.

재현 — Android 11 에뮬 + 컷아웃 흉내 + 가로

에뮬레이터(Pixel 4, Android 11)에서 개발자 옵션의 컷아웃 흉내를 켜고 가로로 돌렸습니다. 명령으로는 이렇게 켤 수 있습니다.

adb shell cmd overlay enable-exclusive --category com.android.internal.display.cutout.emulation.tall

수정 전 빌드가 정확히 같은 문구로 거절당했고, 기록은 a_w=781 s_w=719였습니다. 창 폭 829dp에서 navigationBarsPadding()이 내비게이션 바 48dp를 빼서 781dp를 요청했는데, SDK는 내비게이션 바와 컷아웃 62dp를 둘 다 뺀 719dp를 화면으로 봤습니다. 컷아웃 추정이 맞았습니다.

그런데 같은 조건을 Android 16 에뮬레이터에서 다시 해 보니 재현되지 않았습니다. 가로·컷아웃 그대로인데 배너가 창 전체 폭으로 정상 로드됐습니다. 예전 기준의 화면 폭이 남아 있는 구버전 OS에서만 나는 문제였고, 실패 기록이 나온 세 기기와도 맞습니다. 최신 OS 에뮬레이터로만 확인했다면 이번에도 놓쳤을 것입니다.

조건결과
세로 방향 (어느 OS든)컷아웃이 위쪽이라 폭에 영향 없음 — 정상
가로 + 컷아웃 없는 기기 (노트9)정상 — 재현 안 됨
가로 + 컷아웃 + Android 11 에뮬a_w=781 s_w=719 거절, 배너 빈 자리
가로 + 컷아웃 + Android 16 에뮬정상 — 재현 안 됨

해결 — 요청 폭을 화면 폭 후보의 최솟값으로 누른다

고칠 자리는 두 갈래였습니다. 앱마다 배너 컨테이너에 displayCutoutPadding()을 붙이는 방법과, 공통 광고 라이브러리의 배너 함수에서 요청 폭을 한 번 누르는 방법입니다. 저는 앱 스무 개 남짓이 같은 라이브러리를 쓰고 있어서, 앱별로 복사해 고치다 일부만 고쳐지는 일을 피하려고 라이브러리 쪽을 골랐습니다. 아래가 그 코드입니다(실제 코드).

internal fun bannerWidthDp(context: Context, slotDp: Int): Int {
    val candidates = runCatching {
        fun dp(ctx: Context): Int {
            val m = ctx.resources.displayMetrics
            return if (m.density > 0f) (m.widthPixels / m.density).toInt() else 0
        }
        listOf(
            dp(context),
            dp(context.applicationContext),
            context.resources.configuration.screenWidthDp,
            context.applicationContext.resources.configuration.screenWidthDp,
        )
    }.getOrDefault(emptyList())
    val fit = clampBannerWidth(slotDp, candidates)
    if (fit != slotDp) Log.i(LOG_TAG, "banner width: slot=$slotDp -> $fit (screen=$candidates)")
    return fit
}

// 0 이하인 후보는 "모른다"라 무시한다.
internal fun clampBannerWidth(slotDp: Int, screenDps: List<Int>): Int =
    (screenDps.filter { it > 0 } + slotDp).min()

그리고 loadBanner가 받은 자리 폭을 바로 쓰지 않고 이 값을 거쳐 getCurrentOrientationAnchoredAdaptiveBannerAdSize에 넘깁니다. 앱 쪽 배너 컴포저블은 BoxWithConstraints의 maxWidth를 그대로 넘기기만 합니다.

SDK가 정확히 어느 값을 화면 폭으로 쓰는지는 공개된 자료에서 찾지 못했습니다. 그래서 후보를 다 모아 가장 작은 값을 고르는 쪽을 택했습니다. 넓게 요청하면 광고가 0이 되지만, 좁게 요청하면 양옆에 여백이 조금 생길 뿐이라 틀려도 덜 아픈 방향입니다. 액티비티 컨텍스트와 앱 컨텍스트를 둘 다 보는 것은, 기기에 따라 두 값의 기준이 다를 수 있다고 보고 넣은 안전장치입니다. 0 이하 후보를 거르는 것도 일부러입니다. 못 구한 값 0을 최솟값으로 삼으면 폭이 0이 되어 적응형이 아닌 고정 배너로 떨어집니다.

확인 방법

1. 실측 숫자 그대로 단위 테스트

GA4에서 나온 세 기기의 a_w와 s_w를 그대로 넣어, 자리 폭이 화면보다 넓으면 화면 폭으로 눌리는지 봅니다. 대조군으로 세로 방향처럼 자리 폭이 화면 안일 때는 건드리지 않는지, 후보가 0·음수·빈 목록일 때는 자리 폭을 그대로 두는지도 같이 넣었습니다. 대부분의 배너는 세로 방향에서 뜨니, 여기서 괜히 줄이면 멀쩡한 배너가 작아집니다.

assertEquals(837, BokAds.clampBannerWidth(866, listOf(914, 837, 837, 837)))   // SM-A315N
assertEquals(695, BokAds.clampBannerWidth(732, listOf(695)))                  // moto g62
assertEquals(411, BokAds.clampBannerWidth(411, listOf(411, 411, 411, 411)))   // 세로, 그대로
assertEquals(866, BokAds.clampBannerWidth(866, listOf(0, -1)))                // 모르는 후보 무시

2. 재현했던 에뮬에서 로그로 확인

같은 Android 11 에뮬, 같은 컷아웃 흉내, 같은 가로 방향에서 수정 빌드를 돌리면 logcat에 banner width: slot=781 -> 718이 찍히고 테스트 광고가 실렸습니다. 세로로 돌리면 이 로그가 아예 안 나오고 배너도 정상이었습니다. 로그가 "눌렀을 때만" 찍히게 해 둔 것은, 이후 배포 전 점검에서 세로 기기의 배너가 건드려지지 않았는지를 바로 보기 위해서입니다.

3. 배포 전 점검에 한 줄 추가

이 뒤로 앱을 올릴 때마다 실기기 점검 기록에 배너가 화면에 실제로 그려진 좌표와 will not fit 0을 같이 적고 있습니다. 다만 제 점검 기기는 컷아웃이 없어서 이 줄은 회귀가 없다는 확인일 뿐이고, 가로·컷아웃 경로는 에뮬레이터로 따로 봐야 합니다.

에뮬에서 광고가 안 보일 때
제 공통 라이브러리는 자동 검사 기기를 걸러 내는 판정이 있어서, 에뮬레이터에 시스템 설정 firebase.test.lab=true가 남아 있거나 x86_64 에뮬에 갓 설치한 상태면 광고를 일부러 막습니다. 재현할 때 배너가 안 나오면 이 문제인지 SDK 거절인지부터 갈라야 합니다. 이건 제 라이브러리 사정이고 애드몹 SDK의 동작은 아닙니다.

자주 묻는 것

얼마나 자주 나는 문제였나요?

60일 전수로 전 앱 합쳐 3건이었습니다. 드뭅니다. 다만 화면 방향을 고정하지 않은 앱이 22개 중 18개였고, 한 번 걸리면 그 기기에서 가로로 보는 내내 배너가 안 뜨는데 사용자 눈에는 빈 자리일 뿐이라 아무도 알려 주지 않습니다. 실패 계측이 없었다면 3건조차 몰랐을 것입니다. 고친 버전이 나간 뒤 이 숫자가 실제로 줄었는지는, 원래 건수가 너무 적어 아직 말할 수 있는 단계가 아닙니다.

displayCutoutPadding()을 붙이면 안 되나요?

그것도 방법입니다. 저는 앱마다 붙여야 하는 수정은 한두 곳을 빠뜨리기 쉬워서 라이브러리 한 곳에서 누르는 쪽을 골랐습니다. 대신 이 방식은 공통 라이브러리 버전을 올리고 앱마다 다시 배포해야 반영됩니다. 저는 이 수정 하나 때문에 따로 배포하지 않고, 각 앱의 다음 배포에 같이 실었습니다.

LocalConfiguration.screenWidthDp를 써도 되는 경우가 있나요?

배너가 창 폭 전체를 쓰고 양옆에 패딩이나 인셋이 하나도 없다면 결과가 같을 수 있습니다. 하지만 edge-to-edge를 켜고 시스템 바 패딩을 넣는 순간 자리 폭과 어긋납니다. 저는 8월 수정 이후로 자리 폭을 넘기고, 그 값을 다시 화면 폭 후보로 누르는 두 단계를 기본으로 씁니다.

오류 코드 1이면 전부 이 문제인가요?

아닙니다. 코드 1은 요청이 잘못됐다는 넓은 분류라 광고 단위 ID 같은 설정 문제도 같은 코드로 옵니다. 메시지에 Ad size will not fit on screen이 있고 a_w가 s_w보다 클 때가 이 경우입니다. 그래서 배너 실패를 남길 때 코드만이 아니라 메시지 원문까지 같이 싣는 것이 중요했습니다.

728x90
반응형
LIST
728x90
반응형
SMALL

성경 앱 1.1.6 버전에서 치명 크래시가 한 건 들어왔습니다. 레노버 태블릿을 쓰는 사용자 한 명이었고, 스택은 Material3 ListItem의 측정 코드에서 끝났는데 제 코드는 한 줄도 찍혀 있지 않았습니다. 제 폰에서는 홈 화면을 아무리 열어도 재현되지 않았습니다. 화면 폭이 아주 좁아지면 아이콘 자리를 빼고 남는 폭이 음수가 되는 라이브러리 쪽 결함으로 보고 Compose BOM을 올렸는데, 원인을 좁힌 과정과 어디까지 확인했는지를 정리합니다.

증상 — 태블릿 한 대, 한 번, 내 프레임 없음

앱은 한영 성경 읽기 앱입니다. 홈 화면 맨 위에 "이어 읽기" 카드와 "오늘의 통독" 카드가 있고, 그 아래에 구약·신약 탭과 책 목록이 이어집니다. 두 카드 모두 ElevatedCard 안에 Material3 ListItem을 하나씩 넣은 단순한 구조입니다.

1.1.6 버전에서 들어온 치명 크래시는 1명, 1건이었습니다. 기기는 Lenovo Tab P11 Pro 2nd Gen(TB132FU), Android 14였습니다. 예외는 이랬습니다.

java.lang.IllegalArgumentException: maxWidth must be >= than minWidth
    at ... androidx.compose.material3.ListItemMeasurePolicy ...
    at ... NodeMeasuringIntrinsics.minHeight ...
    (이하 Compose 내부 프레임 — 앱 패키지 프레임 없음)

위 블록은 스택에서 핵심 프레임만 옮겨 적은 것입니다. 앱 패키지 이름이 들어간 줄이 하나도 없어서, 어느 화면의 어느 ListItem인지 스택만으로는 알 수 없었습니다.

처음에는 제목만 보였습니다. Crashlytics API로 이슈를 가져오면 제목만 왔고, 전체 스택은 Play Console의 데이터를 주는 Play Developer Reporting API(vitals.errors.reports.search)로 따로 받아야 했습니다. ListItemMeasurePolicy라는 프레임은 그렇게 받은 전체 스택에서 처음 봤습니다.

원인 — 카드 안 ListItem, 그리고 좁아진 폭

스택에 제 코드가 없으니 후보를 화면 구조로 좁혔습니다. 이 앱에서 ListItem을 쓰는 곳은 세 군데입니다.

위치부모leading / trailing판단
홈 "이어 읽기" 카드일반 Column 안 ElevatedCard아이콘 / 없음후보
홈 "오늘의 통독" 카드일반 Column 안 ElevatedCard아이콘 / 진도 숫자·연속 일수유력 후보
통독 하루 분량 화면LazyColumn의 items없음 / 화살표 아이콘부모가 지연 목록이라 제외

크래시 스택의 부모 쪽이 LazyColumn이 아니라 일반 Column 안의 카드였기 때문에, 홈 화면 두 카드 중 하나라고 봤습니다. 특히 "오늘의 통독" 카드는 오른쪽 trailing 자리에 진도 숫자와 불꽃 아이콘을 세로로 쌓아 두어서, 양옆이 가장 많이 차는 카드입니다.

ListItem은 측정할 때 leading과 trailing을 먼저 재고, 가로 폭에서 그 둘과 안쪽 여백을 뺀 나머지를 가운데 글자 영역에 줍니다. 화면이 넉넉하면 문제가 없습니다. 그런데 태블릿에서 앱을 화면 분할이나 팝업 창으로 아주 좁게 띄우면, 빼고 남은 값이 0보다 작아질 수 있습니다. 최소 폭보다 최대 폭이 작은 제약을 만들려는 순간 Compose가 바로 이 maxWidth must be >= than minWidth를 던집니다. 스택에 minHeight, 곧 intrinsic 측정 경로가 찍힌 것도 실제 배치 전에 "이 폭이면 높이가 얼마냐"를 묻는 단계에서 터졌다는 뜻으로 읽었습니다.

당시 앱의 Compose BOM은 2024.12.01, Material3는 1.3 계열이었습니다. 저는 이것을 그 버전의 ListItem 측정 코드가 음수 폭을 걸러 주지 않는 결함으로 봤습니다. 다만 이건 스택과 화면 구조로 내린 판단이고, 고치기 전 버전으로 크래시를 직접 재현하지는 못했습니다. 이 점은 아래 확인 방법에서 다시 적습니다.

폰에서는 안 걸리는 이유
폰을 세로로 들고 앱을 전체 화면으로 쓰면 카드 폭이 수백 dp라 남는 폭이 음수가 될 일이 없습니다. 제 실기기도 갤럭시 노트9 한 대라 평소 테스트에서는 이 경로를 밟지 않았습니다. 같은 1.1.6이 폰 사용자들에게는 아무 일 없이 돌았고, 크래시는 태블릿 한 대에서만 났습니다.

해결 — 내 코드를 고치지 않고 BOM을 올렸다

제 코드에 잘못된 값을 넘기는 곳이 없으니, 화면 코드는 그대로 두고 라이브러리를 올리는 쪽을 골랐습니다. 같은 시기에 만든 단식 타이머와 엑셀 앱은 이미 2026.02.01을 쓰고 있었고 거기서 돌려 본 상태였기 때문에, 그 버전으로 맞췄습니다.

# gradle/libs.versions.toml — 실제 변경 (2026-11-14)
-composeBom = "2024.12.01"
+composeBom = "2026.02.01"

후보였던 카드의 실제 모양은 이렇습니다. 바뀐 줄은 없고, 어떤 구조가 이 크래시의 조건이 되는지 보여 드리려고 옮깁니다.

// TodayReadingCard.kt — 실제 코드, 일부 생략
ElevatedCard(
    modifier = Modifier
        .fillMaxWidth()
        .padding(horizontal = 12.dp, vertical = 8.dp)
        .clickable(enabled = state.loaded, onClick = onClick)
) {
    ListItem(
        headlineContent = { Text(/* 오늘의 통독 · N일차 */) },
        supportingContent = {
            Text(text = state.label, maxLines = 1, overflow = TextOverflow.Ellipsis)
        },
        leadingContent = { Icon(Icons.AutoMirrored.Filled.MenuBook, contentDescription = null) },
        trailingContent = {
            if (state.loaded) {
                Column(horizontalAlignment = Alignment.End) {
                    Text("${state.readCount}/${state.totalDays}")
                    // 연속 일수가 있으면 불꽃 아이콘 + 숫자 한 줄 더
                }
            }
        }
    )
}

BOM을 올리면 Material3만이 아니라 Compose UI, 파운데이션도 같이 바뀝니다. 그래서 이 수정 하나만 따로 내지 않고, 미뤄 두었던 홈 카드 노출 계측, 처음 읽고 돌아온 사용자에게 알림을 한 번 묻는 기능과 함께 묶어 1.1.7로 단위 테스트, 릴리스 빌드, 실기기 확인을 한 번에 거쳤습니다.

확인 방법 — 폰으로 좁은 창을 흉내 낸다

1. wm size로 화면 폭을 줄인다

태블릿 대신 노트9의 화면 해상도를 강제로 좁혀 분할 창을 흉내 냈습니다. 높이는 그대로 두고 폭만 330, 220, 160픽셀로 내려가며 릴리스 빌드로 홈 화면을 열었고, 글자 크기까지 1.6배로 키워 양옆이 더 빨리 차게 했습니다. 아래 명령은 그때 쓴 값으로 다시 적은 재구성입니다.

# 재구성 — 노트9에서 쓴 값
adb shell wm size 330x2220
adb shell wm size 220x2220
adb shell wm size 160x2220
adb shell settings put system font_scale 1.6

adb shell wm size 1080x2220   # 끝나면 원래 값으로 (reset 말고 평소 값을 직접)
adb shell settings put system font_scale 1.0

세 폭 모두에서 1.1.7 홈 화면은 죽지 않았습니다. 160픽셀까지 줄였을 때는 삼성 시스템 UI가 먼저 죽었는데, 이건 앱과 상관없는 일이었습니다. 단위 테스트는 146건, 같은 배포에 넣은 알림 안내 기능까지 합친 합본 기준으로는 149건이 통과했습니다.

wm size reset을 쓰지 않은 이유
노트9에서 wm size reset을 하면 평소 쓰던 1080x2220이 아니라 패널의 물리 해상도 1440x2960으로 돌아갑니다. 키보드 좌표처럼 평소 해상도에 맞춰 둔 자동화가 있으면 다 어긋나니, 끝날 때는 원래 값을 직접 넣는 편이 안전합니다.

2. 무엇을 확인 못 했는지도 적어 둔다

이번 확인에는 빈 곳이 있습니다. 고치기 전 1.1.6으로 같은 좁은 폭을 만들어 크래시를 일부러 띄워 보지는 못했습니다. 그래서 "BOM을 올려서 고쳐졌다"가 아니라 "올린 버전은 좁은 폭에서 죽지 않는다"까지만 말할 수 있습니다. 1.1.7은 11월 15일 오후에 프로덕션으로 나갔고, 최종 판정은 같은 크래시가 1.1.7에서 다시 0건인지를 Play Vitals에서 보는 것으로 정해 두었습니다. 이 글을 쓰는 시점에는 출시 후 이틀이 지났을 뿐이고, 사용자 한 명에게 한 번 난 크래시라 판정에는 시간이 더 걸립니다.

3. 같은 BOM을 쓰는 다른 앱을 훑는다

라이브러리 결함이라면 같은 버전을 쓰는 다른 앱도 조건만 맞으면 걸립니다. 제 앱들의 버전 카탈로그를 훑어보니 대부분이 아직 2024.12.01이었고, 그중 ListItem을 쓰는 앱은 장날 알림 앱 하나였습니다. 그쪽은 아직 크래시 보고가 없어 손대지 않았지만, 다음 배포 때 BOM을 같이 올릴 후보로 적어 두었습니다.

자주 묻는 것

스택에 내 코드가 없으면 어느 화면인지 어떻게 찾나요?

제 경우에는 두 가지로 좁혔습니다. 하나는 스택 이름 그 자체입니다. ListItemMeasurePolicy가 보이면 범위가 ListItem을 쓰는 곳으로 줄어듭니다. 다른 하나는 부모 쪽 프레임의 모양입니다. 지연 목록인지 일반 Column인지만 가려도 후보가 확 줄었습니다. 그래도 하나로 못 좁혀서, 이번에는 두 카드를 모두 덮는 라이브러리 업그레이드를 골랐습니다.

BOM 대신 Modifier로 막을 수는 없나요?

카드에 최소 폭을 주거나, 좁을 때 trailing을 숨기는 식으로 앱 코드에서 피해 갈 수도 있었을 겁니다. 다만 저는 그렇게 하지 않았고 효과를 확인한 적도 없습니다. 이미 다른 앱에서 돌고 있는 상위 BOM이 있었기 때문에 그쪽이 바뀌는 부분이 더 적다고 봤습니다.

Crashlytics에서 스택이 안 보이면요?

제가 쓰는 Crashlytics 조회 경로에서는 이 이슈의 제목만 왔습니다. Play에 올린 앱이라면 Play Console의 Android Vitals에도 같은 크래시가 쌓이고, Play Developer Reporting API의 vitals.errors.reports.search로 전체 스택을 받을 수 있었습니다. 프레임 하나 차이로 범위가 크게 바뀌는 경우라 두 곳을 다 보는 편이 낫습니다.

한 명에게 한 번 난 크래시도 고칠 가치가 있나요?

제 판단은 그랬습니다. 후보가 둘 다 앱을 열면 바로 보이는 홈 화면 카드였고, 이번 달에 여러 앱을 태블릿 화면에 맞추는 작업을 하던 중이라 태블릿 사용자를 버릴 수 없었습니다. 대신 1명 1건이라 하루 늦어지는 손해는 작다고 보고, 그날 밤 바로 올리지 않고 다음 날 다른 수정과 묶어 출시했습니다.

728x90
반응형
LIST
728x90
반응형
SMALL

날씨 앱에서 코루틴 취소가 실패로 세지는 것을 고치고 배포했는데, 이틀 뒤 매일 받는 앱 상태 메일에 날씨 새로고침 실패가 4건 중 4건, 100%로 찍혀 있었습니다. 취소 가드를 Result 체인의 onFailure 안에 넣었는데, 체인은 적은 순서대로 돌기 때문에 바로 앞의 also가 취소를 이미 실패 이벤트로 보낸 뒤였습니다. 같은 수정이 비교 화면은 통째로 빠뜨려서 그쪽에는 가드가 아예 없었습니다. 오류도 크래시도 없이 숫자만 틀어져 있던 경우라, 원인과 고친 코드, 되돌려서 확인한 방법을 정리합니다.

증상 — 고쳤다고 믿은 다음 날에도 실패율이 그대로

이 앱은 홈 화면을 열 때마다 위치를 잡고 서버에서 날씨를 새로 받습니다. 새로고침이 끝나면 성공 여부를 weather_refresh 이벤트의 success 값으로 GA4에 보내고, 실패하면 따로 app_issue 이벤트로 실패 원인을 남깁니다. 매일 아침 받는 상태 메일은 이 두 이벤트를 모아 앱별 실패율을 보여 줍니다.

9월 7일, 실패 원인을 예외 클래스 이름 대신 고정 키로 보내도록 바꾸면서 취소 가드도 하나 넣었습니다. runCatching은 Throwable을 전부 잡기 때문에, 사용자가 화면을 벗어나거나 새로고침이 다시 시작돼 코루틴이 취소되면 CancellationException까지 Result.failure로 담깁니다. 그게 장애로 세지지 않게 하려던 것입니다. 이 버전은 같은 날 프로덕션에 나갔습니다.

그런데 이틀 뒤 메일에서 weather_refresh가 4건 중 4건 실패였습니다. app_issue 쪽에서는 취소가 빠져 있었는데 weather_refresh의 실패율에는 그대로 남아, 두 지표가 서로 맞지 않았습니다. 가드는 분명히 있었고 테스트도 통과했으니, 코드만 보면 고쳐진 것처럼 보였습니다.

원인 — Result 체인은 적은 순서대로 돈다

9월 7일에 넣은 모양은 이랬습니다.

// 날씨 앱 HomeViewModel.loadWeather — 9/7 커밋 직후 (실제 코드, 일부)
refreshWeather(location)
    .also { result ->
        analyticsLogger.logEvent(
            AnalyticsEvent.WEATHER_REFRESH,
            mapOf(
                AnalyticsParam.SOURCE to locationSource,
                AnalyticsParam.SUCCESS to result.isSuccess,   // ← 취소도 false 로 실린다
            ),
        )
    }
    .onFailure { e ->
        if (e is CancellationException) throw e            // ← 가드는 그 다음
        analyticsLogger.recordIssue(
            "weather", "refresh_failed",
            "${FailureReason.describe(e)} source=$locationSource",
            ourFault = false,
        )
        if (_uiState.value is HomeUiState.Loading) {
            _uiState.value = HomeUiState.Error(e.message ?: "Failed to load weather")
        }
    }

also와 onFailure는 둘 다 Result를 받아 그대로 돌려주는 평범한 확장 함수라, 위에서 아래로 순서대로 실행됩니다. 취소가 담긴 Result가 오면 먼저 also가 success=false로 이벤트를 보내고, 그다음에야 onFailure가 취소인 것을 알아보고 다시 던집니다. 그래서 app_issue와 에러 화면은 막혔지만 weather_refresh 이벤트는 이미 나간 뒤였습니다.

취소가 이 자리까지 오는 경로는 이렇습니다. 저장소의 refreshWeather는 runCatching { coroutineScope { async ... } } 모양이라, 안쪽 중단점에서 취소가 터지면 예외로 던져지는 대신 Result에 담겨 돌아옵니다. 홈 화면의 loadWeather는 시작할 때 activeLoadJob?.cancel()로 앞의 작업을 취소하고, viewModelScope는 화면이 정리될 때 취소됩니다. 취소된 코루틴이라도 다음 중단점을 만나기 전까지는 일반 코드가 계속 돌기 때문에, Result를 받은 직후의 also는 그대로 실행됩니다.

자리9/7 상태취소가 오면
홈 weather_refresh 이벤트가드보다 앞success=false로 나감 (메일의 4/4)
홈 app_issue 실패 원인가드 뒤막힘
홈 에러 화면가드 뒤막힘
비교 화면 compare_loaded 이벤트가드 없음success=false로 나감
비교 화면 상태가드 없음UiState.Error로 바뀜

비교 화면(어제와 오늘 날씨 비교)은 같은 패턴의 코드인데, 9월 7일 커밋이 홈만 고치고 이 화면을 통째로 빠뜨렸습니다. 취소가 오면 계측이 틀어지는 데 더해, onFailure가 상태를 에러로 바꾸는 코드였습니다. 호출부마다 if (e is CancellationException)를 손으로 적는 방식이라 한 군데를 놓친 것입니다.

제가 확인하지 못한 것
메일의 4건이 전부 취소였는지는 이벤트만으로 가를 수 없었습니다. weather_refresh에는 성공 여부만 있고 실패 원인이 없기 때문입니다. 확실한 것은 "취소가 오면 이 코드는 반드시 success=false를 보낸다"는 것이고, 아래 테스트로 그것을 재현했습니다.

해결 — 가드를 체인 맨 앞으로, 한 곳으로

9월 9일에 Result 확장 함수 하나를 만들고, runCatching 결과를 받는 모든 호출부의 첫 줄에 두었습니다.

// 날씨 앱 util/ResultCancellation.kt — 9/9 신설 (실제 코드)
import java.util.concurrent.CancellationException

fun <T> Result<T>.rethrowIfCancelled(): Result<T> {
    val e = exceptionOrNull()
    if (e is CancellationException) throw e
    return this
}
// 날씨 앱 HomeViewModel.loadWeather — 9/9 고친 뒤 (실제 코드, 일부)
refreshWeather(location)
    // 취소 판정은 계측보다 먼저 와야 한다.
    .rethrowIfCancelled()
    .also { result ->
        analyticsLogger.logEvent(
            AnalyticsEvent.WEATHER_REFRESH,
            mapOf(
                AnalyticsParam.SOURCE to locationSource,
                AnalyticsParam.SUCCESS to result.isSuccess,
            ),
        )
    }
    .onFailure { e -> /* 실패 원인 기록, 에러 화면 */ }

비교 화면도 같은 위치에 .rethrowIfCancelled()를 넣었고, 홈의 onFailure 안에 있던 중복 가드는 걷어냈습니다.

두 가지를 일부러 지켰습니다. 하나는 취소를 return으로 삼키지 않고 같은 예외 객체를 다시 던지는 것입니다. 코루틴 취소는 위로 전파돼야 부모가 정리를 마치는데, 여기서 조용히 끝내면 이미 취소된 스코프에서 뒷일이 계속 돕니다. 다른 하나는 java.util.concurrent.CancellationException으로 검사하는 것입니다. kotlinx의 CancellationException은 JVM에서 이것의 typealias라서 코루틴 취소도 같이 걸립니다. 이 사실은 테스트로 따로 못 박아 두었습니다.

그물이 새면 보이게 해 둔 장치
실패 원인을 고정 키로 바꾸는 함수(FailureReason)는 CancellationException을 "cancelled"로 분류합니다. 어딘가 가드가 빠져 취소가 onFailure까지 내려가면 GA4에 cancelled라는 값이 찍히므로, 누락 자체가 드러납니다. CancellationException은 IllegalStateException의 자식이라, 분류 순서에서 그보다 앞에 둬야 합니다.

확인 방법 — 고친 걸 일부러 되돌려 본다

1. 취소를 Result로 흘려 넣는 테스트

ViewModel 테스트에서 유스케이스가 Result.failure(CancellationException(...))를 돌려주게 하고, 이벤트가 0번 나가는지와 상태가 에러로 바뀌지 않는지를 봅니다. 비교 화면에는 "취소는 compare_loaded를 남기지 않는다", "취소는 에러 화면을 띄우지 않는다" 두 테스트를 넣었습니다. 유닛 테스트는 기존 119건에 12건이 늘어 131건이 통과했고, 계측 테스트 66건과 R8 릴리스 빌드도 통과했습니다.

2. 되돌려서 빨간불을 본다

이번 건에서 제일 결정적이었던 단계입니다. 고친 코드를 임시로 무르고 테스트를 돌리니 정확히 5건이 깨졌고, 실패 메시지에 결함이 그대로 찍혀 나왔습니다. logEvent(weather_refresh, {source=gps, success=false})와 Error(message=job was cancelled)입니다. 9월 7일 가드도 테스트를 통과했던 만큼, 되돌려 보지 않았다면 새 테스트가 원래부터 통과하는 테스트인지 구분할 수 없었습니다.

3. 대조군 — 진짜 실패는 살아 있어야 한다

취소를 막다가 진짜 장애까지 삼키면 고치려던 것과 반대 사고가 납니다. 그래서 "취소가 아닌 실패는 그대로 통과한다"와 "진짜 실패는 success=false로 남고 에러 화면도 뜬다"를 대조군 테스트로 같이 두었습니다. 실기기(갤럭시 노트9)에서는 와이파이와 데이터를 끄고 앱을 열어, success=false와 detail=no_network가 담긴 app_issue가 그대로 나가는 것을 logcat으로 봤습니다. 망을 다시 켜고는 weather_refresh {success=true, source=gps}도 확인했습니다. 고친 버전은 같은 날 프로덕션에 나갔습니다.

자주 묻는 것

runCatching을 쓰는 곳은 전부 위험한가요?

그날 다른 앱 17개를 같은 눈으로 훑어보니, 갈림길은 그물 안에 중단점이 있느냐였습니다. runCatching 안에서 withContext나 async를 기다리면 취소가 거기서 터져 확실히 잡힙니다. 반면 input.read() 같은 블로킹 루프만 있거나 suspend가 아닌 함수라면 취소가 그 자리에서 터지지 않습니다. 또 하나, 아무도 취소하지 않는 앱 전역 스코프에서 도는 호출부라면 가드가 있어도 무해할 뿐 실제로 도달하지는 않습니다.

Flow의 catch도 같은 문제가 있나요?

홈 화면은 Room 캐시를 Flow로 받으면서 .catch로 에러 상태를 만드는데, 이쪽은 손대지 않았습니다. kotlinx의 catch 연산자는 자기 스코프의 취소는 잡지 않고 다시 던지기 때문입니다. 훑어볼 때 이 자리는 오탐으로 분류했습니다.

try-catch로 쓰는 코드는요?

같은 원리입니다. catch (e: Exception)이 CancellationException까지 잡으니, 그 앞에 catch (e: CancellationException) { throw e }를 먼저 둬야 합니다. 제 앱 중 증거 사진 앱은 8월 23일에 JobCancellationException이 사흘간 53건 실패로 잡힌 뒤 이 모양으로 고쳐 두었고, 장날 알림 앱도 이미 그렇게 돼 있었습니다. WorkManager 작업 하나는 취소를 catch (e: Exception)이 잡아 Result.retry()로 바꾸고 있어, 계측 오염은 없지만 취소된 작업을 되살리는 상태로 남아 있습니다.

왜 호출부마다 if를 쓰지 않고 함수로 뺐나요?

9월 7일 수정이 정확히 그 방식으로 비교 화면 하나를 빠뜨렸기 때문입니다. 함수 하나로 모으면 "runCatching 결과를 받으면 첫 줄은 rethrowIfCancelled()"라는 규칙 하나만 보면 되고, 코드 검색으로 빠진 자리를 찾기도 쉽습니다.

728x90
반응형
LIST
728x90
반응형
SMALL

메뉴 추천 앱을 태블릿에 맞추면서, 화면 폭이 640dp를 넘으면 남는 폭을 좌우 여백으로 돌려 내용을 가운데에 모으게 했습니다. 태블릿 크기로 바꾼 에뮬레이터에서는 잘 모였는데, 이틀 뒤 테스트용 폰(Android 10)을 가로로 눕히니 여백이 하나도 없었습니다. 여백 계산을 인셋 리스너 안에만 넣어 두었고, 이 앱은 edge-to-edge를 켜지 않아서 그 폰에서는 리스너가 아예 불리지 않았던 겁니다. 오류도 로그도 없이 기능 하나가 조용히 빠져 있던 경우라, 원인과 고친 코드, 확인 방법을 정리합니다.

증상 — 에뮬레이터에선 가운데, 실기기에선 끝까지

이 앱은 Compose가 아니라 XML 레이아웃과 자바로 만든 View 앱입니다. 그래서 폭을 묶는 수식어 대신, 화면 폭에서 640dp를 넘는 만큼을 반으로 나눠 루트 레이아웃의 좌우 패딩으로 주는 방식을 썼습니다. 처음 넣은 코드는 이랬습니다.

// 메뉴 추천 앱 MainActivity.onCreate — 11/12 처음 넣은 모양 (실제 코드)
// edge-to-edge 인셋 처리 (targetSdk 35+)
View root = findViewById(R.id.rootLayout);
ViewCompat.setOnApplyWindowInsetsListener(root, (v, insets) -> {
    Insets bars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
    // 태블릿·펼친 폴더블: 폭이 640dp 를 넘으면 남는 폭을 좌우 여백으로 돌린다.
    int side = sideGutterPx();
    v.setPadding(bars.left + side, bars.top, bars.right + side, bars.bottom);
    return WindowInsetsCompat.CONSUMED;
});

/** 내용 폭을 640dp 로 묶을 때 좌우 한쪽에 줄 여백(px). 640dp 이하 화면(폰)은 0. */
private int sideGutterPx() {
    int extraDp = Math.max(0, (getResources().getConfiguration().screenWidthDp - 640) / 2);
    return Math.round(extraDp * getResources().getDisplayMetrics().density);
}

원래 그 자리에는 상태 표시줄·내비게이션 바만큼 패딩을 주는 리스너가 이미 있었습니다. targetSdk 35부터 Android 15 기기에서는 edge-to-edge가 강제돼 앱이 시스템 바 뒤까지 그려지기 때문에 넣어 둔 것입니다. 여백도 "패딩을 정하는 곳"이니 같은 리스너에 한 줄 더한 것이 자연스러워 보였습니다.

11월 13일 API 36 에뮬레이터의 화면 크기를 2560x1600, 밀도 320으로 바꿔 첫 화면을 봤을 때는 내용이 가운데 640dp에 잘 모였습니다. 그런데 11월 14일 배포 전 실기기 점검에서 갤럭시 노트9(Android 10)을 가로로 눕히자 폭이 약 800dp인데도 칩과 버튼이 화면 양 끝까지 퍼져 있었습니다. 계산대로면 양쪽에 80dp씩 여백이 있어야 했습니다. 크래시도 경고도 없었고, 세로 화면은 원래 여백이 0이라 아무 차이가 없었습니다.

원인 — 리스너는 "인셋이 내려올 때"만 불린다

setOnApplyWindowInsetsListener는 뷰에 창 인셋이 전달될 때 불리는 콜백입니다. 화면 크기가 바뀌었다고 불리는 것이 아니라, 인셋이 그 뷰까지 내려와야 불립니다. edge-to-edge를 켰는지에 따라 이 전달이 달라집니다.

환경시스템 바 영역루트 뷰의 인셋 리스너리스너 안에만 둔 여백
Android 15 이상 + targetSdk 35 이상edge-to-edge 강제, 앱이 바 뒤까지 그림불림 (에뮬레이터 API 36에서 확인)들어감
Android 10, edge-to-edge 안 켬 (이 앱)시스템이 바 영역을 먼저 빼고 앱 화면을 줌안 불림 (노트9 실기기에서 확인)0
어느 OS든 enableEdgeToEdge를 켠 앱앱이 바 뒤까지 그림불림들어감

edge-to-edge를 안 켠 창에서는 시스템이 상태 표시줄·내비게이션 바만큼을 먼저 처리하고 남은 영역을 앱에 줍니다. Android 10에서는 그렇게 처리된 인셋이 루트 레이아웃까지 내려오지 않았고, 리스너 안에 있던 여백 계산도 같이 건너뛰어졌습니다. 시스템 바 패딩은 시스템이 이미 해 준 셈이라 표가 안 났고, 여백만 사라졌습니다.

리스너가 원래 "Android 15에서 바에 가리는 걸 막는 용도"였기 때문에, 그 자리에 둔 코드는 Android 15 이상에서만 확실히 돈다고 봐야 했습니다. 거기에 OS와 상관없이 늘 돌아야 하는 여백 계산을 얹은 것이 실수였습니다.

제가 실제로 본 범위
리스너가 안 불리는 것을 실기기로 확인한 것은 Android 10 하나입니다. 코드 주석에는 "14 이하"로 적어 두었지만, Android 11-14 실기기에서 리스너가 아예 안 불리는지, 불리되 바 인셋이 0으로 오는지는 확인하지 못했습니다. 아래 고친 코드는 어느 쪽이든 여백이 들어가게 만든 것입니다.

왜 테스트에서 안 걸렸나

11월 12일 커밋은 디버그 컴파일만 확인한 상태였고, 다음 날 화면 확인은 API 36 에뮬레이터 하나로 했습니다. Android 15 이상에서는 edge-to-edge가 강제라 리스너가 반드시 불리니, 에뮬레이터에서는 결함이 생길 수가 없었습니다. 폰 세로 화면은 폭이 640dp에 못 미쳐 원래 여백이 0이니 여기서도 차이가 없습니다. "구형 OS"와 "640dp 넘는 폭"이 겹치는 조건, 이번에는 노트9 가로 화면에서만 드러났습니다.

해결 — 리스너 밖에서 먼저 넣고, 리스너는 덮어쓰게

여백을 onCreate에서 한 번 먼저 넣고, 리스너가 불리는 OS에서는 리스너가 바 인셋과 합쳐 다시 덮어쓰게 했습니다.

// 메뉴 추천 앱 MainActivity.onCreate — 11/14 고친 뒤 (실제 코드)
View root = findViewById(R.id.rootLayout);
// 🚨여백은 리스너 밖에서도 먼저 넣는다. 이 앱은 edge-to-edge 를 켜지 않아 안드로이드 14 이하에서는
//   아래 리스너가 아예 불리지 않는다(시스템이 인셋을 먼저 써 버린다). 리스너 안에만 두었더니
//   노트9(Android 10) 가로 화면에서 여백이 0 이었다(2026-11-14 실기기). 15 이상에서는 리스너가 덮어쓴다.
int initialSide = sideGutterPx();
root.setPadding(initialSide, root.getPaddingTop(), initialSide, root.getPaddingBottom());
ViewCompat.setOnApplyWindowInsetsListener(root, (v, insets) -> {
    Insets bars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
    int side = sideGutterPx();
    v.setPadding(bars.left + side, bars.top, bars.right + side, bars.bottom);
    return WindowInsetsCompat.CONSUMED;
});

위·아래 패딩은 getPaddingTop()·getPaddingBottom()으로 레이아웃에 있던 값을 그대로 두고 좌우만 바꿨습니다. 이 화면은 매니페스트에 configChanges가 없어 회전하면 액티비티가 다시 만들어지므로, onCreate에서 넣는 값도 회전 때마다 새 폭으로 다시 계산됩니다. 회전을 직접 처리하는 화면이라면 onConfigurationChanged에서도 같은 계산을 해야 합니다.

같은 패턴을 쓰는 다른 앱은 괜찮았나
같은 날 태블릿 대응을 넣은 또 하나의 View 앱(저장공간 정리 앱)도 여백 계산이 인셋 리스너 안에 있습니다. 그 앱은 액티비티에서 enableEdgeToEdge()를 부르고 있어 모든 OS에서 리스너가 불리므로 손대지 않았습니다. 리스너 안에 레이아웃 계산이 있다면, 먼저 그 앱이 edge-to-edge를 켰는지부터 보면 됩니다.

확인 방법 — 구형 OS와 넓은 폭을 같이 만든다

1. 구형 OS 실기기를 가로로

제게는 Android 10 노트9의 가로 화면이 두 조건을 다 갖춘 유일한 기기였습니다. 고친 버전을 다시 올려 가로로 눕히니 양쪽에 여백이 생겨 내용이 가운데로 모였고, 세로 화면은 그대로였습니다. 이 항목을 실기기 점검표에 "태블릿 폭과 폰 가로, Android 14 이하에서도"로 새로 넣어 다음 배포부터 매번 보게 했습니다.

2. 에뮬레이터라면 OS 버전부터 내린다

에뮬레이터 화면 크기를 키우는 방법은 폭 문제를 보는 데는 좋지만, 이미지가 Android 15 이상이면 이번 결함은 절대 안 보입니다. Android 14 이하 이미지에서 adb shell wm size와 wm density로 폭을 640dp 넘게 만들어야 같은 조건이 됩니다. 저는 남은 시스템 이미지가 API 36 하나뿐이라 이 확인은 실기기로 했습니다.

3. 리스너가 불렸는지 직접 찍기

눈으로 여백을 재기 애매하면 리스너 첫 줄에 로그를 하나 넣고 구형 기기에서 화면을 열어 보면 됩니다. 로그가 안 찍히면 그 안의 코드는 그 기기에서 한 번도 돌지 않은 것입니다. 확인이 끝나면 로그는 지웁니다.

자주 묻는 것

그냥 enableEdgeToEdge를 켜면 되지 않나요?

켜면 리스너가 모든 OS에서 불리니 그것도 방법입니다. 다만 그러면 Android 14 이하에서도 앱이 시스템 바 뒤까지 그려지므로, 상태 표시줄 아이콘 색과 바 영역 배경까지 다시 봐야 합니다. 이번에는 배포 직전이라 화면 전체의 그리는 방식을 바꾸지 않고 여백 한 가지만 고쳤습니다.

사용자에게 나간 버전에도 있었나요?

아니요. 여백을 넣은 11월 12일 커밋은 아직 배포 전이었고, 배포 전 실기기 점검에서 잡혀 고친 버전이 같은 날 세 단계 테스트를 통과했습니다. 이 글을 쓰는 11월 14일 기준 출시 대기 중입니다.

폰 가로 화면은 이제 다 괜찮나요?

여백은 들어가지만, 같은 점검에서 폰 가로 화면에서 결과 글자가 카테고리 칩 위에 겹치는 문제를 따로 봤습니다. 칩과 입력칸 사이 높이가 모자라서 생기는 것으로, 이번 수정 전 버전에도 있던 것입니다. 가로 레이아웃은 별도 작업으로 남겨 두었습니다.

Compose 앱도 해당되나요?

Compose에서 widthIn(max) 같은 수식어로 폭을 묶었다면 인셋 전달과 상관없이 늘 적용되니 이 문제는 아닙니다. 다만 Compose에서도 인셋 콜백 안에서 레이아웃 값을 계산하고 있다면 같은 질문을 해 볼 만합니다. "이 코드는 인셋이 안 내려오는 기기에서도 돌아야 하는가."

728x90
반응형
LIST
728x90
반응형
SMALL

제가 만든 성경 읽기 앱은 태블릿에서 본문이 너무 넓게 퍼지지 않도록 내용 폭을 640dp로 묶어 두었습니다. 그런데 그 제한이 처음부터 한 번도 걸린 적이 없었습니다. 폭 제한 수식어를 화면 전체 폭을 채우는 수식어 뒤에 붙인 순서 하나 때문이었고, 폰 세로 화면에서는 제한이 있든 없든 똑같이 보여서 두 달 넘게 그대로 있었습니다. 같은 실수가 단식 타이머 앱에서는 진행 링을 화면 폭만큼 키워 시작 버튼을 화면 밖으로 밀어내고 있었습니다. 왜 이런 일이 생기는지, 어떻게 고쳤는지, 어떻게 확인하는지 정리합니다.

증상 — 코드에는 640dp가 있는데 화면은 끝까지 찬다

문제의 코드는 이런 모양이었습니다. 성경 앱의 "오늘" 화면에서 고치기 전 코드입니다.

// 매일성경 TodayScreen — 고치기 전 (실제 코드, 일부)
Column(
    modifier = Modifier.fillMaxSize(),
    horizontalAlignment = Alignment.CenterHorizontally
) {
    Column(
        modifier = Modifier
            .weight(1f)
            .fillMaxWidth()
            .widthIn(max = 640.dp)
            .verticalScroll(rememberScrollState())
            .padding(16.dp)
    ) {
        // 오늘의 말씀 카드들
    }
}

읽으면 "폭을 채우되 최대 640dp까지, 바깥 Column이 가운데로 모은다"로 보입니다. 바깥에 CenterHorizontally까지 걸어 둔 걸 보면 만들 때 의도도 분명했습니다. 프로젝트 상태 문서에도 "태블릿·폴더블 반응형(widthIn 640dp)"에 완료 표시가 붙어 있었습니다.

처음 낌새를 본 것은 2026년 9월 11일 실기기 점검이었습니다. 폰을 가로로 눕혀 보는 항목에서 카드 폭이 약 765dp로 나왔습니다. 640을 넘었으니 제한이 안 걸린 것인데, 그날은 가로 화면이 조금 넓어 보이는 정도라 "기록만" 하고 넘어갔습니다. 그 뒤 알려진 결함 목록에도 "fillMaxWidth 뒤에 widthIn이라 가로 화면에서 약 765dp"라고 원인까지 적어 두고는 손대지 않았습니다.

그대로 두면 안 된다고 본 것은 11월 12일, 앱 전체를 대화면 기준으로 점검하던 날이었습니다. 27개 앱 중 태블릿에 제대로 대응된 앱은 9개뿐이었고, 대응했다고 믿었던 앱 중에도 이 순서 문제가 있었습니다. 성경 앱은 다섯 곳이 같은 모양이었고, 단식 타이머는 더 심했습니다.

// 단식 타이머 TimerScreen — 고치기 전 (실제 코드)
Box(
    Modifier.fillMaxWidth().widthIn(max = 320.dp).aspectRatio(1f),
    contentAlignment = Alignment.Center,
) {
    // 진행 링
}

링은 가로세로 1:1이라 폭이 그대로 높이가 됩니다. 320dp에 묶였어야 할 링이 태블릿 폭만큼 커지니, 그 아래 있는 시작·종료 버튼이 첫 화면 밖으로 밀려났습니다. 성경 앱은 보기에 조금 아쉬운 정도였지만, 이쪽은 앱의 핵심 버튼이 안 보이는 문제였습니다.

원인 — 수식어는 바깥에서 안쪽으로 제약을 넘긴다

Compose의 Modifier는 왼쪽(먼저 쓴 것)이 바깥입니다. 부모가 준 크기 제약이 왼쪽 수식어부터 차례로 안쪽으로 내려가고, 각 수식어는 받은 제약 안에서만 새 제약을 만들 수 있습니다. 이 규칙 하나로 순서에 따른 차이가 설명됩니다.

순서첫 수식어가 넘기는 제약두 번째 수식어의 결과태블릿(약 1280dp 폭)에서
fillMaxWidth().widthIn(max = 640.dp)최소 = 최대 = 부모 폭(1280dp)으로 고정640을 받은 범위 1280~1280 안으로 맞추면 다시 1280끝까지 찬다 — 제한 무시
widthIn(max = 640.dp).fillMaxWidth()0~640dp그 범위의 최대인 640을 채움640dp, 부모 정렬로 가운데

fillMaxWidth()는 단순히 "넓게"가 아니라 최소 폭과 최대 폭을 둘 다 부모 폭으로 못 박습니다. 그 뒤에 오는 widthIn(max)는 이미 정해진 범위를 벗어날 수 없으니 아무 일도 안 하게 됩니다. 오류도 경고도 없습니다. 제 경우 컴파일은 그대로 통과했고, 실행해도 로그 한 줄 안 남았습니다.

폰에서는 왜 안 보였나

테스트 기기로 쓰는 폰은 세로 화면 폭이 640dp에 한참 못 미칩니다. 폭 제한이 걸려도 안 걸려도 결과가 똑같이 "화면 폭"입니다. 순서가 틀린 코드와 맞는 코드가 폰 세로 화면에서는 한 픽셀도 다르지 않으니, 평소 쓰는 기기로는 절대 드러나지 않습니다. 9월에 잡힌 것도 폰을 가로로 눕혀 폭이 640을 넘었을 때뿐이었습니다.

정답이 이미 다른 앱에 적혀 있었습니다.
공고 알림 앱의 공용 반응형 함수 주석에는 "widthIn을 fillMaxSize보다 먼저 둬야 한다. 순서가 반대면 minWidth를 부모 폭으로 고정해 widthIn(max)가 무력화된다"고 적혀 있었습니다. 한 앱에서 알아낸 함정이 다른 앱으로 옮겨지지 않았던 겁니다. 이번에 앱 공통 개발 규칙 문서로 올렸습니다.

해결 — 제한을 먼저, 채우기를 나중에

고친 것은 순서뿐입니다. 성경 앱 다섯 곳을 모두 같은 방식으로 바꿨습니다.

// 매일성경 TodayScreen — 고친 뒤 (실제 코드, 일부)
Column(
    modifier = Modifier
        .weight(1f)
        .widthIn(max = 640.dp)
        .fillMaxWidth()
        .verticalScroll(rememberScrollState())
        .padding(16.dp)
) { ... }

// 매일성경 ReaderScreen — Box(contentAlignment = TopCenter) 안
LazyColumn(
    state = listState,
    modifier = Modifier
        .widthIn(max = 640.dp)
        .fillMaxSize()
        .padding(horizontal = 16.dp)
) { ... }

단식 타이머 링도 순서를 바꾸고, 다시 뒤집히지 않도록 이유를 주석으로 남겼습니다.

// 단식 타이머 TimerScreen — 고친 뒤 (실제 코드)
Box(
    // 🚨widthIn 이 fillMaxWidth 보다 앞이어야 한다. 뒤에 두면 폭이 부모 폭으로 굳어 제한이 무시되고
    //   태블릿에서 링이 화면 폭만큼 커져 시작·종료 버튼이 아래로 밀렸다(2026-11-12 점검).
    Modifier.widthIn(max = 320.dp).fillMaxWidth().aspectRatio(1f),
    contentAlignment = Alignment.Center,
) { ... }

부모가 가운데로 모아 주지 않을 때

순서만 바꾸면 폭은 640dp가 되지만, 부모가 정렬을 안 해 주면 왼쪽에 붙습니다. 단식 타이머의 탭 내용 상자가 그런 경우였습니다. 이럴 때는 앞에 fillMaxWidth()로 자리를 다 차지한 뒤 wrapContentWidth()로 최소 폭을 풀고 가운데로 모은 다음, 그 안에서 폭을 묶습니다.

// 단식 타이머 MainActivity — 탭 줄은 끝까지, 내용만 가운데 640dp (실제 코드)
Box(Modifier.fillMaxWidth().weight(1f).wrapContentWidth().widthIn(max = 640.dp)) {
    when (tab) { ... }
}

여기서는 fillMaxWidth()가 앞에 있어도 괜찮습니다. 바로 뒤의 wrapContentWidth()가 최소 폭을 0으로 풀어 주기 때문에, 그다음 widthIn(max)가 다시 일을 할 수 있습니다. 탭 줄이나 툴바 색 띠처럼 끝까지 이어져야 보기 좋은 것은 묶지 않고, 그 아래 내용만 묶는 것이 제 기준입니다.

모든 화면에 걸면 안 됩니다.
화면 전체를 써야 하는 화면(디스플레이 검사, 카메라 미리보기)에는 폭 제한을 걸지 않았습니다. 사진 격자는 폭을 묶는 대신 GridCells.Fixed(n)을 GridCells.Adaptive(minSize)로 바꿔 넓은 화면에서 열 수가 늘어나게 했습니다.

확인 방법 — 태블릿이 없어도 폭은 볼 수 있다

1. 에뮬레이터 화면 크기를 태블릿으로 바꾸기

태블릿 실기기는 없고, 태블릿용 에뮬레이터 이미지도 지워진 상태라 폰 에뮬레이터의 화면 크기와 밀도를 바꿔 확인했습니다. 2560x1600에 밀도 320이면 약 1280x800dp로, 태블릿 가로 화면과 같은 폭입니다.

adb -s <에뮬레이터> shell wm size 2560x1600
adb -s <에뮬레이터> shell wm density 320
# 확인이 끝나면 원래 값으로 직접 되돌린다

11월 13일 이 방법으로 다시 봤을 때 성경 앱은 오늘·통독·읽기·설정 네 화면 모두 가운데 640dp로 모였습니다(고치기 전에는 끝까지 찼습니다). 읽기 화면 맨 아래 "이 분량 완료" 버튼만 전체 폭으로 남았는데, 하단 고정 버튼이라 그대로 두었습니다. 단식 타이머는 링이 320dp에 묶이고 시작 버튼이 첫 화면에 보였습니다. 두 앱 모두 실기기 점검표에 이 태블릿 폭 항목을 새로 넣어, 다음 배포부터는 매번 보게 했습니다.

2. 폰을 가로로 눕혀 보기

에뮬레이터를 띄우기 번거로우면 폰 가로 화면이 첫 번째 거름망이 됩니다. 9월에 이 문제를 처음 본 것도 가로 화면이었습니다. 다만 폰 가로 폭은 기기에 따라 640dp를 겨우 넘거나 못 넘을 수 있어서, 제한값이 크면 가로에서도 안 걸립니다. 확실히 보려면 1번이 낫습니다.

3. 코드에서 순서 찾기

화면을 보기 전에 코드에서 먼저 걸러 낼 수도 있습니다. fillMaxWidth()나 fillMaxSize() 바로 다음에 widthIn(이 오는 곳을 찾으면 됩니다. 수식어를 여러 줄로 나눠 쓴 곳은 한 줄 검색에 안 걸리니, 줄을 넘는 검색으로 찾아야 합니다. 찾은 자리 중 사이에 wrapContentWidth()가 끼어 있는 곳은 정상입니다.

자주 묻는 것

지금 태블릿 대응을 챙겨야 하는 이유가 있나요?

targetSdk 36(안드로이드 16)부터는 짧은 쪽이 600dp 이상인 화면에서 screenOrientation 세로 고정과 화면비 제한이 무시됩니다. 세로 고정이라 태블릿은 상관없다고 생각한 앱도 태블릿과 펼친 폴더블에서는 가로로 돕니다. 예외는 <application android:appCategory="game">로 게임이라고 밝힌 앱뿐이라, 제 앱 중 게임 하나에만 그걸 넣었습니다. 나머지는 넓은 화면에서도 보기 좋게 내용 폭을 묶는 쪽으로 갔습니다.

height 쪽도 같은가요?

원리는 같습니다. fillMaxHeight()나 fillMaxSize() 뒤의 heightIn(max)도 같은 이유로 무시됩니다. 제가 이번에 실제로 고친 것은 폭 쪽뿐이었습니다.

View로 만든 앱은 어떻게 했나요?

Compose가 아닌 View 앱 두 개는 이 수식어가 없으니, 화면 폭(screenWidthDp)에서 640dp를 넘는 만큼을 좌우 여백으로 돌리는 방식으로 맞췄습니다.

사용자에게는 이미 나간 건가요?

순서가 틀린 코드는 성경 앱 저장소의 첫 기록부터 있었고, 그동안 나간 버전에 모두 들어 있었습니다. 고친 버전은 이 글을 쓰는 11월 13일 기준으로 세 단계 테스트를 통과하고 출시 대기 중입니다. 태블릿 사용자가 이 문제로 불편을 알려 온 적은 없어서, 실제로 몇 명이 겪었는지는 모릅니다.

728x90
반응형
LIST
728x90
반응형
SMALL

여러 앱이 같이 쓰는 제 공용 광고 라이브러리에 전면광고 콜백을 만들어 주는 함수가 있는데, 거기 괄호 밖 람다로 넘긴 코드가 "광고를 닫았을 때"가 아니라 "띄우지 못했을 때" 인자로 들어가고 있었습니다. 타입이 우연히 맞아서 컴파일 오류도 경고도 없었고, 광고도 평소처럼 떴다 닫혔습니다. 그 사이 일곱 개 앱에서 두 달 넘게 닫은 뒤의 간격 기록과 다음 광고 미리 받기가 한 번도 돌지 않았습니다. 왜 이렇게 됐는지, 인자 순서를 어떻게 바꿨는지, 다시 뒤집히지 않게 무엇을 걸어 두었는지 정리합니다.

증상 — 광고는 뜨고 닫히는데 그 뒤가 비어 있다

2026년 11월 1일, 전면광고 노출 횟수와 마지막 노출 시각을 메모리가 아니라 디스크(SharedPreferences)에 남기도록 라이브러리를 고치고 있었습니다. 앱을 켤 때마다 카운터가 0부터 시작해서 "N번에 한 번" 조건이 거의 안 차던 문제를 잡는 작업이었습니다. 고친 버전을 실기기에 올려 전면광고를 띄우고 닫은 다음 저장소를 열어 봤더니, 닫을 때 써야 할 마지막 노출 시각(last_로 시작하는 키)이 저장돼 있지 않았습니다.

따라가 보니 저장 코드가 아니라 저장 함수를 부르는 줄이 실행되지 않고 있었습니다. 그 줄은 앱 쪽에서 광고 콜백에 넘긴 람다 안에 있었습니다.

// 장날 알림 앱의 실제 호출부 (주석 일부 생략)
ad!!.fullScreenContentCallback = BokAds.fullScreenCallback("interstitial") {
    // 광고를 오래 들여다본 만큼 다음 광고도 밀린다 — 닫힌 시각으로 잡는다.
    gate.markShown(System.currentTimeMillis())
    loadInterstitial(activity)
}
ad.show(activity)

읽는 사람 눈에는 "광고가 닫히면 시각을 기록하고 다음 광고를 받아 둔다"로 보입니다. 코드 안의 주석도 그렇게 적혀 있습니다. 화면에서 보이는 것은 정상이었습니다. 광고가 뜨고, 닫기를 누르면 닫히고, 앱은 하던 일을 계속했습니다. 크래시도, 로그 오류도 없었습니다.

원인 — 괄호 밖 람다는 "마지막 함수형 인자"에 붙는다

문제는 라이브러리 함수의 인자 순서였습니다. 2026년 8월 25일 이 함수를 처음 만들 때 시그니처가 이랬습니다.

// 0.9.4 ~ 0.10.19 (고치기 전)
fun fullScreenCallback(
    kind: String,
    where: String = TAG,
    onDismissed: () -> Unit = {},
    onShowFailed: (AdError) -> Unit = { onDismissed() },
): FullScreenContentCallback

Kotlin은 괄호 밖에 쓴 람다를 마지막 인자로 넘깁니다. 여기서 마지막 인자는 onDismissed가 아니라 onShowFailed였습니다. 그러니 위 호출은 실제로는 이렇게 쓴 것과 같았습니다.

// 컴파일러가 실제로 본 호출 (재구성)
BokAds.fullScreenCallback(
    kind = "interstitial",
    onShowFailed = { gate.markShown(...); loadInterstitial(activity) },
    // onDismissed 는 기본값 {} — 닫아도 아무것도 안 한다
)

그런데 왜 컴파일이 됐을까요. onShowFailed의 타입은 (AdError) -> Unit, 인자가 하나인 함수입니다. 인자가 하나인 람다는 이름을 안 적으면 암시적으로 it을 받습니다. 람다 안에서 it을 한 번도 안 써도 오류가 아닙니다. 결국 () -> Unit을 의도하고 쓴 블록이 (AdError) -> Unit 자리에 문제없이 들어갔습니다.

상황불린 콜백실제로 돈 코드
광고를 정상으로 닫음 (대부분)onAdDismissedFullScreenContent기본값 {} — 간격 기록 없음, 다음 광고 안 받음
광고를 띄우지 못함 (드묾)onAdFailedToShowFullScreenContent앱이 넘긴 람다 — 간격 기록, 다음 광고 받기

정리하면 의도한 코드는 드물게 생기는 실패 경로에서만 돌았고, 흔한 정상 경로에서는 빈 람다가 돌았습니다. 라이브러리 기록에 남긴 표현대로, 노출이 한 기회씩 밀렸고 간격 제한은 사실상 꺼져 있었습니다.

같은 라이브러리를 쓰는데 멀쩡한 앱도 있었다

피해는 전부가 아니라 일곱 개 앱이었습니다. 나머지 앱은 같은 함수를 이렇게 이름을 붙여 부르고 있었습니다.

// 단식 타이머 앱의 실제 호출부 (일부)
ready.fullScreenContentCallback = BokAds.fullScreenCallback(
    kind = "interstitial",
    where = ADS_WHERE,
    onDismissed = {
        ad = null
        showing = false
        gate.markShown(System.currentTimeMillis())
        cadence.markShown()
        preload()
        onClosed(true)
    },
    ...
)

이름을 붙이면 순서와 상관없이 정확한 자리에 들어갑니다. 같은 함수, 같은 버전인데 "호출하는 모양"만으로 앱이 둘로 갈렸습니다. 게다가 라이브러리 함수의 사용 예시 주석이 바로 그 짧은 괄호 밖 람다 모양이었습니다. 문서대로 쓴 쪽이 당한 셈입니다.

해결 — 주로 쓰는 콜백을 마지막 인자로 옮긴다

고친 것은 인자 두 개의 순서입니다. 다만 순서만 바꾸면 컴파일이 안 됩니다. 기존 코드에서 onShowFailed의 기본값이 { onDismissed() }였는데, Kotlin의 기본값 식은 앞에 선언된 인자만 참조할 수 있습니다. 실패 콜백을 앞으로 보내면 아직 선언되지 않은 onDismissed를 기본값에서 쓸 수 없습니다. 그래서 실패 콜백을 null 허용으로 바꾸고, null이면 본문에서 닫힘 콜백으로 넘기게 했습니다.

// 0.10.20 (고친 뒤)
@JvmStatic
@JvmOverloads
fun fullScreenCallback(
    kind: String,
    where: String = TAG,
    onShowFailed: ((AdError) -> Unit)? = null,
    onDismissed: () -> Unit = {},
): FullScreenContentCallback = object : FullScreenContentCallback() {

    override fun onAdDismissedFullScreenContent() {
        onDismissed()
    }

    override fun onAdFailedToShowFullScreenContent(error: AdError) {
        showFailed("${kind}_show_failed", error, where)
        onShowFailed?.invoke(error) ?: onDismissed()
    }
    // onAdClicked 등 나머지 생략
}

이렇게 하면 괄호 밖 람다는 onDismissed로 들어가고, 실패 콜백을 따로 안 넘긴 앱은 예전처럼 실패했을 때도 같은 처리를 합니다. 보상형광고처럼 "보상 없이 닫힘"을 갈라야 하는 곳만 onShowFailed를 이름 붙여 넘기면 됩니다.

좋았던 점은 앱 코드를 한 줄도 안 고쳐도 된다는 것이었습니다. 괄호 밖 람다로 쓴 앱은 라이브러리 버전만 올리면 람다가 저절로 맞는 자리로 가고, 이름을 붙여 쓴 앱은 원래부터 영향이 없습니다. 실제 반영은 앱마다 다시 배포해야 해서 순서대로 올리고 있고, 이 글을 쓰는 11월 12일 기준으로 일곱 개 중 네 개 앱이 고친 버전 이상으로 올라가 있습니다.

함수형 인자가 둘 이상이면 "괄호 밖에 올 법한 것"을 맨 뒤에 두세요.
Kotlin 표준 라이브러리도 대부분 주 람다를 마지막에 둡니다. 순서를 지킬 자신이 없으면, 앞쪽 함수형 인자를 nullable로 두거나 호출부에서 이름 붙여 부르기를 규칙으로 정하는 편이 낫습니다. 제 경우 인자 타입이 서로 달랐는데도(() -> Unit과 (AdError) -> Unit) 암시적 it 때문에 컴파일러가 걸러 주지 않았습니다.

확인 방법 — 순서를 다시 뒤집으면 실패하는 테스트

1. 회귀 테스트

이 호출 모양 그대로를 확인하는 단위 테스트를 이번 수정 때 처음 넣었습니다. 괄호 밖 람다를 넘기고, 닫힘 콜백을 직접 불러서 람다가 돌았는지만 봅니다.

/**
 * 🚨0.10.19 까지 괄호 밖 람다가 `onShowFailed` 로 들어가 닫아도 아무 일도 안 일어났다(7개 앱).
 * 인자 순서를 다시 바꾸면 이 테스트가 잡는다.
 */
@Test
fun `괄호 밖 람다는 광고를 닫았을 때 돈다`() {
    var dismissed = 0
    val cb = BokAds.fullScreenCallback("interstitial", "test") { dismissed++ }
    cb.onAdDismissedFullScreenContent()
    assertEquals(1, dismissed)
}

나중에 누가 "실패 콜백이 앞에 있으니 어색하다"며 순서를 원래대로 돌리면, 컴파일은 여전히 되지만 이 테스트가 0을 보고 실패합니다. 함수 주석과 라이브러리 안내 문서에도 "닫힘 콜백이 반드시 마지막 인자여야 한다, 되돌리지 말 것"을 적어 두었습니다.

2. 실기기에서 닫은 뒤의 흔적 보기

이번에 결함을 드러낸 것은 테스트가 아니라 실기기였습니다. 광고를 한 번 띄우고 닫은 다음, 닫을 때 남아야 하는 값(제 경우 마지막 노출 시각)이 실제로 저장됐는지를 봤습니다. 콜백이 "불렸다"가 아니라 "그 안의 일이 끝났다"를 확인하는 것이 핵심입니다. 화면만 보고는 광고가 뜨고 닫혔으니 정상으로 보였기 때문입니다.

공용 라이브러리라 피해가 한 번에 넓었습니다.
한 앱의 실수였다면 그 앱만 고치면 됐겠지만, 라이브러리의 예시 주석 자체가 이 모양이었으니 따라 쓴 앱마다 같은 결함을 안고 있었습니다. 고칠 때 예시는 그대로 두고 함수 시그니처 쪽을 예시에 맞췄습니다. 일곱 개 앱이 이미 그렇게 쓰고 있었으니까요.

자주 묻는 것

IDE나 컴파일러가 경고를 안 주나요?

제 경우는 컴파일이 그대로 통과했고, 그래서 두 달 동안 아무도 몰랐습니다. 람다를 마지막 인자에 붙이는 것은 정상 문법이고, 인자 하나짜리 람다에서 it을 안 쓰는 것도 오류가 아닙니다. 타입이 () -> Unit과 (AdError) -> Unit으로 달랐는데도, 람다 쪽에서 매개변수를 따로 적지 않았기 때문에 어느 쪽에도 맞았습니다.

람다에 매개변수를 적었으면 걸렸을까요?

{ error -> ... }처럼 매개변수를 적고 닫힘 콜백 자리를 노렸다면 타입이 안 맞아 컴파일 오류가 났을 겁니다. 반대로 매개변수 없는 블록은 양쪽에 다 들어가서 걸러지지 않습니다. 실패 사유가 필요 없는 콜백일수록 매개변수를 안 적으니, 이 함정에 그대로 빠집니다.

광고 수익에는 얼마나 영향이 있었나요?

이 결함 하나만 떼어 낸 숫자는 없습니다. 같은 날 고친 카운터 문제(앱을 켤 때마다 0이 되던 것)와 겹쳐 있었고, 두 수정이 같은 배포에 실려 나갔기 때문입니다. 확실히 말할 수 있는 것은 닫은 뒤 다음 광고를 미리 받아 두는 일과 간격 기록이 정상 경로에서 빠져 있었다는 것까지입니다.

Java에서 부르는 앱도 영향이 있나요?

Java에는 괄호 밖 람다 문법이 없어서 인자를 순서대로 넘깁니다. 그래서 이 함정은 Kotlin 호출부에만 해당합니다. 다만 순서를 바꾸면 Java 호출부는 인자 위치가 달라지므로, Java에서 이 함수를 순서대로 부르는 곳이 있다면 같이 확인해야 합니다. 이번에 피해를 본 일곱 개는 모두 Kotlin 앱이었습니다.

728x90
반응형
LIST
728x90
반응형
SMALL

단식 타이머 앱에 독일어, 프랑스어, 브라질 포르투갈어, 일본어 번역을 넣었는데 실기기에서 독일어로 띄워 보니 화면이 전부 영어였습니다. 번역 파일은 키 수까지 맞았고 단위 테스트도 다 통과한 상태였습니다. 원인은 build.gradle.kts의 resourceConfigurations에 예전 언어 셋만 적혀 있어서, 새로 넣은 번역이 빌드 단계에서 APK 밖으로 통째로 빠지고 있던 것이었습니다. 같은 줄을 반대로 일부러 써서 효과를 본 앱도 있어서, 왜 이 줄을 두는지와 언어를 더할 때 무엇을 같이 바꿔야 하는지를 함께 정리합니다.

증상 — 번역은 있는데 화면은 영어

2026년 11월 6일, 단식 타이머 앱에 네 언어를 더했습니다. 커밋에 들어간 것은 문자열 파일 네 개뿐이었습니다.

app/src/main/res/values-de/strings.xml     | 181 +++
app/src/main/res/values-fr/strings.xml     | 188 +++
app/src/main/res/values-ja/strings.xml     | 174 +++
app/src/main/res/values-pt-rBR/strings.xml | 188 +++
4 files changed, 731 insertions(+)

키는 기본 values/와 똑같이 144개였습니다. 문자열 키 대조, plurals 확인, 제가 쓰는 문자열 감사 스크립트, 단위 테스트까지 전부 초록불이었습니다. 다음 날 배포 전 실기기 확인에서 디버그 빌드에 언어를 강제로 지정해 띄웠는데, 탭 이름도 버튼도 영어 그대로였습니다. 오류 메시지는 하나도 없었습니다. 로그에도, 빌드 출력에도요. 앱은 정상으로 돌았고 단지 번역이 없는 것처럼 행동했습니다.

이게 고약한 이유는 기본 언어가 영어라는 데 있습니다. 번역이 없으면 안드로이드는 조용히 values/의 영어로 물러납니다. 그 결과가 "번역이 반쯤 덜 된 앱"이 아니라 "멀쩡한 영어 앱"이라서, 독일어 기기를 직접 들고 있지 않으면 눈치챌 방법이 없습니다. 제 폰은 한국어이고, 한국어는 원래 셋 안에 들어 있었으니 평소처럼 열어 봐서는 아무 차이가 없었습니다.

원인 — resourceConfigurations가 셋으로 묶여 있었다

build.gradle.kts의 defaultConfig에 이 줄이 있었습니다.

// 영어가 기본(values/), 한국어(values-ko/)를 같이 낸다. 그 밖의 라이브러리 번역은 뺀다 —
// 앱은 영어인데 라이브러리 다이얼로그만 다른 말로 뜨는 것을 막는다(sdcheck 9/28 실측).
resourceConfigurations += listOf("en", "ko", "es")

resourceConfigurations는 여기 적힌 언어의 리소스만 APK에 남기고 나머지는 빌드 때 지웁니다. 의존 라이브러리의 번역만 걸러 내는 줄로 알고 넣었지만, 실제로는 앱 자기 자신의 values-xx도 똑같이 거릅니다. 그래서 소스 트리에는 values-de가 멀쩡히 있는데, 만들어진 APK 안에는 독일어 문자열이 한 줄도 없었습니다.

확인한 것결과왜 못 잡았나
키 수 대조통과소스의 strings.xml끼리 비교한다. 빌드 결과는 안 본다
plurals·문자열 감사 스크립트통과역시 res 폴더를 읽는다
단위 테스트통과JVM에서 돌고 화면 언어와 상관이 없다
내 폰(한국어)으로 열기정상ko는 원래 목록에 있었다
언어를 강제한 실기기 화면영어여기서 처음 드러났다

작업이 나뉘어 있었던 것도 한몫했습니다. 번역 파일을 넣는 작업은 파일만 만들고 "빌드 전"으로 커밋했고, 빌드와 실기기 확인은 다음 날 배포 준비에서 따로 했습니다. 파일을 넣는 쪽에서는 build.gradle.kts를 열 이유가 없었고, 그 파일에 언어 목록이 있다는 것도 떠올리지 못했습니다.

그런데 이 줄은 왜 있었나 — 반대로 효과를 본 앱

그냥 지우면 되지 않나 싶지만, 이 줄은 일부러 넣은 것이었습니다. 계기는 SD카드 검사 앱이었습니다. 그 앱은 영어 전용이라 values-ko가 없는데, 앱들이 같이 쓰는 제 공용 라이브러리에는 한국어 문구가 있었습니다. 2026년 9월 28일 한국어 폰에서 열어 보니 영어 화면 위에 업데이트 안내만 한국어로 떴습니다. 그래서 그 앱에는 영어만 남기도록 이렇게 박았습니다.

// 🚨이 앱은 영어 전용이다(values-ko 가 없다). 그런데 공용 라이브러리는 values-ko 를
//   갖고 있어서, 한국어 기기에서는 앱은 영어인데 라이브러리 다이얼로그만 한국어로 떴다.
//   여기서 ko 리소스를 APK 에서 빼 라이브러리 문구까지 영어로 고정한다.
//   ⚠️앱에 한국어를 넣게 되면 이 줄을 지울 것 — 안 지우면 번역이 조용히 안 먹는다.
resourceConfigurations += listOf("en")

마지막 경고 줄은 그때 이미 적어 두었습니다. 단식 타이머는 이 패턴을 가져다 "en, ko, es"로 쓰고 있었는데, 정작 언어를 더하는 날에는 그 경고를 다시 보지 않았습니다. 같은 한 줄이 한 앱에서는 섞인 언어를 막아 주고, 다른 앱에서는 번역을 지우고 있었던 셈입니다.

앱resourceConfigurations효과
SD카드 검사 앱(영어 전용)en라이브러리의 한국어 다이얼로그가 사라져 화면 언어가 하나로 맞는다
단식 타이머(고치기 전)en, ko, es새로 넣은 de·fr·pt-BR·ja가 APK에서 빠진다
단식 타이머(고친 뒤)en, ko, es, de, fr, pt-rBR, ja앱 번역과 목록이 일치한다

해결 — 언어 목록을 values 폴더와 맞추고, 그 자리에 경고를 남긴다

고친 것은 한 줄입니다. 대신 다음에 또 같은 일을 하지 않도록 이유를 바로 위에 적었습니다.

// 🚨values-<언어> 를 새로 넣으면 여기에도 더할 것 — 빠지면 그 번역이 빌드에서 통째로 지워지고
//   영어로 뜬다(11/7 de·fr·pt-BR·ja 추가 때 실기기에서 발견. 리소스 검사·단위테스트는 다 통과했다).
resourceConfigurations += listOf("en", "ko", "es", "de", "fr", "pt-rBR", "ja")

목록에 쓰는 이름은 폴더 이름의 values- 뒤를 그대로 씁니다. 브라질 포르투갈어 폴더가 values-pt-rBR이니 목록에도 pt-rBR입니다. 기본 values/는 영어라서 en을 넣어 두었습니다.

앱 저장소의 안내 문서 맨 위에도 같은 경고를 올렸습니다. 이번에 이 함정을 밟은 것이 빌드 스크립트를 열지 않는 번역 작업 쪽이었기 때문입니다.

이 줄이 있는 앱인지부터 확인하세요.
번역이 안 먹는다고 strings.xml의 따옴표나 폴더 이름을 의심하기 전에, 앱 모듈의 build.gradle(.kts)에서 resourceConfigurations(또는 localeFilters)를 먼저 찾아보는 편이 빠릅니다. 제 경우 원인은 문자열 파일 쪽이 아니었습니다.

번역을 고친 김에 드러난 것

번역이 실제로 화면에 뜨자 그동안 안 보이던 문제가 나왔습니다. 포르투갈어 설정 탭 이름이 "Configuraç…"로 잘려서 "Ajustes"로 줄였고, 프랑스어·포르투갈어·일본어의 신체 치수 입력칸 라벨이 줄바꿈되어 짧은 표현으로 바꿨습니다. 번역이 APK에 안 들어가 있던 동안에는 이런 잘림도 볼 수가 없었습니다. 번역이 빠진 채로 배포됐다면, 나중에 목록을 고친 날 잘린 화면이 처음 사용자에게 나갔을 겁니다.

확인 방법 — 소스가 아니라 빌드된 APK로 본다

1. 언어를 강제해서 실기기 화면 보기

디버그 빌드에는 기기 언어와 상관없이 앱을 한 언어로 띄우는 값이 있습니다. 원래는 스토어 스크린샷용으로 만든 것인데 이번에 번역 누락을 잡은 것도 이 장치였습니다.

// build.gradle.kts — debug { } 안
buildConfigField("String", "FORCE_LOCALE",
    "\"${project.findProperty("forceLocale") ?: ""}\"")

// MainActivity.kt — 릴리스에서는 늘 빈 값이라 아무것도 안 한다
override fun attachBaseContext(newBase: Context) {
    val tag = BuildConfig.FORCE_LOCALE
    if (tag.isBlank()) return super.attachBaseContext(newBase)
    val locale = Locale.forLanguageTag(tag)
    Locale.setDefault(locale)
    val config = android.content.res.Configuration(newBase.resources.configuration).apply { setLocale(locale) }
    super.attachBaseContext(newBase.createConfigurationContext(config))
}
./gradlew :app:installDebug -PnoAds=true -PforceLocale=de

이렇게 띄운 화면이 영어면, 번역 파일이 있어도 APK에 없다는 뜻입니다. 고친 뒤에는 네 언어로 각각 주요 다섯 화면을 넘겨 보며 번역이 뜨는 것을 확인했습니다.

2. APK 안에 어떤 언어가 들어 있는지 직접 보기

실기기 확인 절차에는 aapt로 APK의 리소스 구성을 찍어 보는 항목도 같이 넣었습니다. 목록에 de, fr 같은 언어가 있는지를 봅니다.

aapt dump configurations app-debug.apk

화면으로 보는 방법은 기기와 시간이 들고, aapt로 보는 방법은 빠르지만 잘림 같은 화면 문제는 못 봅니다. 그래서 둘을 같이 적어 두었습니다.

3. 아직 못 본 것

솔직히 남겨 둔 것도 있습니다. 위젯의 일본어 시간 표기와 런처에서 현지어 앱 이름이 잘리는지는, 앱 안에서만 언어를 강제하는 방식으로는 확인이 안 돼서 미확인으로 기록했습니다. 위젯과 런처는 앱 화면이 아니라 기기 언어를 따르기 때문입니다.

다른 앱도 한 번에 대조했습니다.
같은 패턴을 쓰는 앱 세 개를 열어 resourceConfigurations 목록과 실제 values-xx 폴더를 맞춰 봤고, 셋 다 en, ko로 실제 폴더와 일치했습니다. 언어를 더하는 날에만 어긋나는 문제라, 평소에 한 번 대조해 두면 다음에 무엇을 같이 바꿔야 하는지가 분명해집니다.

자주 묻는 것

resourceConfigurations를 아예 지우면 안 되나요?

지우면 이번 문제는 사라집니다. 대신 의존 라이브러리가 가진 모든 언어가 APK에 들어옵니다. 앱이 지원하지 않는 언어의 기기에서 앱 화면은 영어인데 라이브러리 다이얼로그만 그 나라 말로 뜰 수 있습니다. 제 SD카드 검사 앱이 한국어 폰에서 실제로 그랬습니다. 저는 줄을 남기고 목록을 values 폴더와 맞추는 쪽을 골랐습니다.

localeFilters와는 다른 건가요?

최근 AGP는 같은 역할을 androidResources 블록의 localeFilters로 옮겨 가고 있습니다. 이름이 바뀌어도 하는 일은 같아서, 목록에 없는 언어는 앱 것이든 라이브러리 것이든 빠집니다. 함정도 같습니다. 저는 아직 resourceConfigurations를 쓰고 있습니다.

Play 스토어 등재 언어를 추가하면 되는 것 아닌가요?

별개입니다. 스토어 등재 언어는 스토어 페이지의 제목과 설명이고, 앱 화면의 문자열은 APK의 리소스입니다. 제 단식 타이머도 1.4.0을 준비한 11월 7일 기준으로 앱 안 번역은 일곱 언어였지만 스토어 등재는 영어, 한국어, 스페인어 두 지역뿐입니다.

왜 오류나 경고가 안 나오나요?

빌드 입장에서는 설정대로 리소스를 걸러 낸 정상 동작이기 때문입니다. 실행 중에도 해당 언어 리소스가 없으면 기본 values/로 물러나는 것이 정해진 동작이라 예외가 나지 않습니다. 제 경우 이 문제를 알려 준 것은 빌드도 테스트도 아니고 강제 언어로 띄운 화면 하나였습니다.

728x90
반응형
LIST
728x90
반응형
SMALL

등산 기록 앱의 운동 서비스가 시스템에 의해 되살아날 때마다, 사용자가 아무것도 누르지 않았는데 새 운동이 시작되고 있었습니다. 원인은 onStartCommand를 intent?.action으로만 갈랐다는 한 가지였습니다. START_STICKY 재시작은 intent를 null로 주는데, 앱의 "시작" 호출도 action 없이 보내고 있어서 둘이 똑같이 null로 보였습니다. 이 경로는 제 폰에서도, 계측 테스트에서도 만들어 낼 수 없어서 한 달 동안 아무도 몰랐습니다.

증상 — 누르지 않은 운동 기록이 쌓인다

이 앱은 등산 중에 포그라운드 서비스로 GPS와 걸음 수를 기록합니다. 제조사의 배터리 관리가 그 서비스를 죽이는 일이 잦아서, 서비스는 START_STICKY를 돌려주고 되살아나면 끊긴 세션을 이어받도록 만들어 두었습니다. 다만 2시간이 넘게 끊긴 세션은 이어받지 않고 마무리하며, 그때 이런 비치명 기록을 하나 남깁니다.

Analytics.recordIssue(
    "HikeService", "stale_session",
    "이어받기 창을 넘긴 세션을 마무리함(hikeId=${hike.id})",
)

원래 드물어야 하는 기록입니다. 그런데 2026-09-26에 Crashlytics에서 이 항목을 열어 보니 30일간 102건, 사용자 11명, 26세션이었습니다. 기기는 전부 실사용자의 갤럭시였고, 주별로 나누면 늘고 있었습니다.

기간stale_session 건수
8/27 - 9/1224
9/13 - 9/1937
9/20 - 9/2641

사용자 쪽에서 보면 이렇습니다. 알림창에 운동 중 고정 알림이 뜨고, GPS가 돌고, 기록 목록에 본인이 시작하지 않은 운동이 생깁니다. 그리고 그 유령 세션이 두 시간 뒤 다시 "묵은 세션"이 되어 같은 일이 되풀이됩니다.

더 곤란했던 건 감시 쪽입니다. 같은 recordIssue 한 줄이 GA4와 Crashlytics 양쪽으로 가는데, GA4에는 1건만 올라와 있었습니다. 저는 앱 오류를 GA4 기준으로 매일 훑고 있었기 때문에 경보가 한 번도 울리지 않았습니다. GA4 쪽에서 왜 빠졌는지는 아직 밝히지 못했습니다.

원인 — action이 null인 경우가 둘이었다

고치기 전 onStartCommand는 이런 모양이었습니다(실제 코드에서 관련 부분만 발췌).

override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    startForeground(NOTIFICATION_ID, buildNotification())
    when (intent?.action) {
        ACTION_PAUSE -> setPaused(true)
        ACTION_RESUME -> setPaused(false)
        ACTION_STOP -> { finish(); return START_NOT_STICKY }
        else -> begin()          // ← 여기로 두 경로가 함께 들어온다
    }
    return START_STICKY
}

companion object {
    fun start(context: Context) = send(context, null)   // action 없이 보낸다
    fun pause(context: Context) = send(context, ACTION_PAUSE)
    // ...
}

사용자가 시작을 누르면 start()가 action 없는 intent를 보냅니다. 시스템이 START_STICKY로 서비스를 되살리면 intent 자체가 null로 옵니다. intent?.action은 두 경우 모두 null이라 둘 다 else로 떨어집니다.

들어온 경로intentintent?.action고치기 전 동작
사용자가 시작을 누름non-nullnullbegin()
시스템의 START_STICKY 재시작nullnullbegin() — 같은 갈래
일시정지·재개·종료non-null각 action각 처리

begin()은 끝나지 않은 세션이 있고 2시간 창 안이면 이어받고, 아니면 묵은 세션을 닫은 뒤 새 세션을 만들었습니다. 이어받기만 생각하고 짠 코드라 "재시작인데 이어받을 게 없으면?"이라는 칸이 없었습니다. 그래서 이어받을 세션이 없거나 너무 묵었을 때 재시작이 곧 새 운동이 됐습니다.

왜 내 손에서 재현이 안 됐나

제 폰에서는 서비스가 죽고 되살아나는 일이 거의 없었고, 되살아나더라도 운동 중이라 이어받기 갈래로 갔습니다. 계측 테스트로도 만들 수 없었습니다. 테스트가 startService로 서비스를 띄우면 intent는 언제나 non-null이고, null intent는 시스템만 줍니다. 기존 계측 테스트(죽었다 살아난 세션 이어받기)는 전부 통과하고 있었지만, 그건 사용자가 누른 경로만 본 것이었습니다.

앱 안에서 start()를 부르는 곳은 권한 허용 직후 한 곳뿐이고 부팅 리시버도 없다는 것을 확인했습니다. 사용자가 누르지 않은 시작은 시스템 재시작 말고는 들어올 길이 없었습니다.

해결 — intent가 null인지로 가르고, 판정을 밖으로 뺐다

먼저 분기에 넘기는 값을 바꿨습니다. action이 아니라 intent가 null인지를 봅니다.

when (intent?.action) {
    ACTION_PAUSE -> setPaused(true)
    ACTION_RESUME -> setPaused(false)
    ACTION_STOP -> { /* ... */ return START_NOT_STICKY }
    // intent 가 null 이면 시스템이 START_STICKY 로 되살린 것이다
    else -> begin(userStarted = intent != null)
}

그리고 "어떻게 시작할지"를 서비스 밖의 순수 함수로 뺐습니다. 서비스 안에 두면 null intent 경로를 영영 검증할 수 없기 때문입니다.

internal enum class StartAction { RESUME, START_NEW, STAND_DOWN }

internal fun decideStart(
    hasOngoing: Boolean,
    resumable: Boolean,
    userStarted: Boolean,
): StartAction = when {
    // 살아 있는 세션은 누가 깨웠든 이어받는다 — 한 번의 등산이 여러 기록으로 쪼개지지 않게
    hasOngoing && resumable -> StartAction.RESUME
    userStarted -> StartAction.START_NEW
    else -> StartAction.STAND_DOWN      // 시스템 재시작 + 이어받을 것 없음
}

서비스 쪽은 STAND_DOWN이면 묵은 세션만 닫고 내려갑니다.

val ongoing = hikeRepo.ongoing()
val action = decideStart(
    hasOngoing = ongoing != null,
    resumable = ongoing != null && resumable(ongoing),
    userStarted = userStarted,
)
if (action == StartAction.RESUME) {
    resume(ongoing!!)
} else {
    ongoing?.let { closeStale(it) }     // 닫는 일은 두 갈래 모두에서 한다
    if (action == StartAction.STAND_DOWN) {
        Log.i(TAG, "시스템 재시작이고 이어받을 세션이 없다 — 새 운동을 만들지 않고 내려간다")
        stopForeground(STOP_FOREGROUND_REMOVE)
        stopSelf()
        return@launch
    }
    // ... 새 세션 시작
}
이어받기 갈래를 맨 앞에 둔 데는 이유가 있습니다. 재시작을 통째로 막으면 START_STICKY를 쓴 본래 목적(운동 중 죽은 서비스 이어받기)이 사라지고, 한 번의 등산이 기록 여러 개로 쪼개지던 예전 사고로 되돌아갑니다.

함께 막은 경쟁 조건

고치면서 하나를 더 찾았습니다. begin() 첫 줄의 if (hikeId != 0L) return 가드는 hikeId가 코루틴 안에서 채워지는데 검사는 밖에서 했습니다. onStartCommand가 짧은 간격으로 두 번 들어오면 둘 다 통과해 세션이 두 개 생깁니다. 하나만 이어받히고 나머지는 끝나지 않은 채 남아 다음 운동 때 또 묵은 세션으로 올라옵니다. 진입 즉시 세우는 @Volatile startingSession 플래그를 더해 막았습니다.

확인 방법 — 만들 수 없는 경로를 어떻게 검증했나

null intent 경로는 계측으로 못 만드니, 순수 함수를 JVM 유닛 테스트 7개로 고정했습니다. 여섯 개는 세 입력의 조합별 기대값이고, 마지막 하나는 갈래가 실제로 갈리는지를 봅니다. 함수가 늘 같은 값을 돌려줘도 일부 테스트는 초록불이 나기 때문입니다.

@Test
fun `시스템 재시작 - 이어받을 세션이 없으면 새 운동을 만들지 않는다`() {
    assertEquals(
        StartAction.STAND_DOWN,
        decideStart(hasOngoing = false, resumable = false, userStarted = false),
    )
}

@Test
fun `시스템 재시작 - 살아 있는 세션은 이어받는다`() {
    assertEquals(
        StartAction.RESUME,
        decideStart(hasOngoing = true, resumable = true, userStarted = false),
    )
}

사용자가 누른 경로는 기존 실기기 계측 테스트 3개로 회귀가 없는지 봤고, 릴리스 빌드 컴파일까지 확인했습니다. 유닛 테스트는 시스템 경로를, 계측 테스트는 사용자 경로를 맡아서 서로 겹치지 않습니다.

실제 효과는 Crashlytics로 봤습니다. 이 수정은 1.1.10에 실려 나갔고, 10/17에 7일 단위로 끊어 다시 셌습니다. stale_session은 수정 전 주 41건(9/20-26)에서 1.1.10 이후 10/4-10 3건, 10/11-17 2건이 됐습니다. 더 분명한 변화는 1인당 반복입니다. 수정 전에는 피해자 한 명당 평균 10.3건이 되풀이됐는데, 남은 5건은 서로 다른 5명에게 1건씩이었습니다. 같은 사람에게 두 시간마다 다시 생기던 고리가 끊겼다는 뜻입니다.

다만 41건이라는 기준선은 그대로 믿지 않기로 했습니다. 9/27-10/3 구간에는 고치기 전 버전(1.1.9) 사용자가 18명이었는데도 0건이었습니다. 수정 전 숫자에 몰림(버스트)이 섞여 있었다는 뜻이라, "41에서 2로 줄었다"는 비율보다는 "1인당 반복이 사라졌다"는 쪽이 더 믿을 만한 근거입니다. 0이 되기를 기대하지도 않았습니다. 운동 중 서비스가 죽고 정말로 2시간이 지난 경우는 정상 동작이고, 그 기록도 맞는 기록입니다.

비슷한 서비스가 있다면 onStartCommand에서 intent?.action의 null이 몇 가지 경로를 뜻하는지 세어 보세요. 앱이 action 없는 intent를 하나라도 보낸다면, 그 갈래에는 시스템 재시작이 섞여 들어옵니다.

FAQ

START_REDELIVER_INTENT로 바꾸면 되지 않나요?

제 경우에는 오히려 나빠진다고 봤습니다. 이 플래그는 마지막 intent를 다시 넣어 주는데, 그 intent가 "시작"이면 재시작이 사용자 시작과 완전히 같아 보입니다. 저는 START_STICKY를 그대로 두고 null intent를 "시스템이 깨웠다"는 신호로 쓰는 쪽을 골랐습니다.

시작 intent에 action을 붙이면 해결되지 않나요?

그래도 갈라집니다. 다만 그 경우에도 null intent가 왔을 때 무엇을 할지는 따로 정해야 합니다. 문제의 본질은 action 이름이 아니라 "재시작인데 이어받을 게 없을 때"라는 칸이 코드에 없었다는 것이었습니다.

GA4에서는 왜 1건만 보였나요?

아직 모릅니다. 같은 begin() 안에서 바로 뒤에 부르는 운동 시작 이벤트는 GA4에 정상적으로 올라와 있어서 "프로세스가 죽어 전송이 날아갔다"로도 설명이 안 됐습니다. 확실한 건 비치명 오류의 규모를 GA4 하나로 판정하면 안 된다는 것뿐이고, 그 뒤로 Crashlytics의 비치명 건수도 함께 보도록 감시를 바꿨습니다.

이 경로를 직접 재현해 볼 수는 없나요?

제 환경에서는 만들지 못했습니다. 그래서 재현 대신 판정을 순수 함수로 빼서 입력을 직접 넣는 방법을 썼습니다. 시스템만 만들 수 있는 입력이 있다면, 그 입력을 받는 판단을 서비스 밖으로 꺼내는 것이 제가 찾은 가장 확실한 검증 방법이었습니다.

728x90
반응형
LIST
728x90
반응형
SMALL

약국 찾기 앱의 목록 화면이 LazyColumn 키 중복으로 죽었는데, 그날 저는 앱을 한 줄도 바꾸지 않았습니다. 바뀐 것은 앱이 받아 오는 데이터였고, 수집 스크립트가 서로 다른 구의 약국 두 곳에 같은 id를 붙여 내보낸 것이 원인이었습니다. 겹친 약국들은 기본 화면에는 나오지 않고 '전체' 목록의 맨 아래에만 있어서, 제 폰으로 평소처럼 열어 보면 아무 일도 없었습니다. 데이터 쪽 가드와 앱 쪽 방어를 둘 다 둔 이유와, 지우지 않고 꼬리를 붙인 이유를 정리합니다.

증상 — 사용자 기기에서만 목록이 죽는다

2026년 10월 6일, 출시해 둔 0.5.1 버전에서 치명 크래시가 잡혔습니다. 기기는 SM-A235F였고 메시지는 이랬습니다.

java.lang.IllegalArgumentException: Key "L033084000019" was already used.
If you are using LazyColumn/Row please make sure you provide a unique key for each item.

목록은 약국 id를 키로 씁니다. 실제 코드도 이렇게 단순합니다.

items(shown, key = { it.p.id }) { r -> PharmacyRow(r, state, onOpen, onCall) }

코드만 보면 틀린 곳이 없습니다. id는 약국마다 고유하다는 전제였고, 그 전제는 앱이 아니라 서버 쪽 데이터가 지키고 있었습니다. 그런데 그 데이터는 앱 배포 없이 바뀝니다. 수집 스크립트가 공공데이터를 받아 묶음 파일을 만들고, 앱은 실행할 때 그 파일을 받아 갑니다. 그러니 스토어에 나간 바이너리는 그대로인데 어느 날부터 목록이 죽을 수 있습니다.

원인 — id를 끝 12자리로 잘랐다

약국 데이터는 두 출처를 합칩니다. 그중 한쪽에만 있는 약국에는 인허가 데이터의 관리번호로 id를 만들었는데, 숫자만 뽑은 뒤 끝 12자리만 썼습니다.

'id': 'L' + re.sub(r'\D', '', r.get('관리번호', ''))[-12:],

관리번호는 앞에서부터 연도, 개방자치단체코드, 일련번호 순으로 이어집니다. 끝 12자리에는 자치단체 자리가 들어가지 않습니다. 그래서 다른 구에 있는 약국끼리 일련번호 부분이 같으면 id가 같아졌습니다. 그날 발행된 묶음에서 세어 보니 겹친 id가 96종, 걸린 레코드가 362건이었습니다.

무엇이왜 안 걸렸나
앱 코드바뀐 것이 없다. 키를 id로 쓰는 것 자체는 맞다
단위 테스트테스트용 레코드는 id가 전부 달랐다
내 폰에서 열기기본 화면은 '지금 영업 중'이다. 겹친 약국은 여기 안 나온다
'전체' 목록겹친 약국은 전부 운영시간 정보가 없는 약국이라 맨 아래에 모여 있다. 끝까지 내려야 닿는다
데이터 수집 검사좌표 범위·시도 누락 같은 검사는 있었지만 id 중복 검사는 없었다

겹친 레코드는 전부 한쪽 출처에만 있는 약국, 곧 운영시간을 모르는 약국이었습니다. 이 앱은 운영시간을 모르는 곳을 '영업 확인 필요'로 목록 맨 아래에 둡니다. 기본 화면에서는 아예 빠지고, '전체'를 골라도 한참 내려야 나옵니다. 제가 확인할 때 늘 보던 경로로는 그 자리에 닿지 않았던 것입니다. 나중에 실기기 확인 절차에 이 항목을 넣으면서 "'지금 영업 중'만 보면 통과한다"는 경고를 같이 적어 두었습니다.

키 중복은 겹친 항목이 그려질 때 드러납니다.
제 경우 '전체' 목록을 끝까지 스크롤하는 확인 절차를 넣은 뒤에야 그 자리를 실제로 지나가게 됐습니다. 화면 위쪽만 보고 넘어가면 키가 겹친 데이터를 들고 있어도 멀쩡해 보입니다.

해결 1 — 데이터 쪽: id를 전체 자릿수로, 그리고 발행 전 가드

먼저 원인을 고쳤습니다. 자르지 않고 숫자 전체를 씁니다. 전체 자릿수로 바꾼 뒤 같은 날 영업 중인 25,895행을 다시 세었을 때 중복은 0이었습니다.

def mois_id(r):
    """S2 에만 있는 약국의 id — 'L' + 관리번호의 숫자 전체.
    2026-10-06 까지는 끝 12자리만 썼다. 끝 12자리에는 자치단체가 안 들어간다."""
    return 'L' + re.sub(r'\D', '', r.get('관리번호', ''))

고치는 것만으로는 부족해서, 발행 전에 도는 검사 목록에 id 중복을 넣었습니다. 하나라도 겹치거나 비어 있으면 그 묶음은 발행하지 않습니다.

# 앱이 id 를 목록 key·즐겨찾기 키로 쓴다 — 겹치면 앱이 죽는다(2026-10-06).
dup = [k for k, c in collections.Counter(r['id'] for r in recs).items()
       if c > 1 or not k or k == 'L']
add('unique_ids', not dup, len(dup) if len(dup) > 5 else dup, 'id 중복·빈 id 0건')

k == 'L'까지 잡는 것은 관리번호가 비어 있으면 id가 접두어 L 한 글자만 남기 때문입니다. 그런 레코드가 둘 이상이면 그것도 같은 키입니다.

대가도 있었습니다. 이 방식으로 만든 id 563건이 한 번 바뀌었습니다. id는 즐겨찾기 키이기도 해서, 그 약국을 즐겨찾기해 둔 사용자는 다시 담아야 합니다. 그래도 목록이 죽는 것보다는 낫다고 판단했습니다.

해결 2 — 앱 쪽: 지우지 말고 꼬리를 붙인다

데이터를 고쳐도 앱 쪽 방어가 따로 필요했습니다. 이유는 두 가지입니다. 이 앱은 받기에 실패하면 마지막으로 저장해 둔 묶음으로 물러나는데, 그 옛 캐시에는 중복이 그대로 들어 있습니다. 그리고 데이터는 앞으로도 앱 배포 없이 바뀝니다. 다음 데이터 사고가 또 목록을 죽이게 둘 수는 없었습니다.

/**
 * 같은 id 가 두 번 오면 뒤엣것에 꼬리(`~2`)를 붙인다. id 는 목록 key·지도 마커·즐겨찾기 키다.
 * 지우지 않는다 — 겹친 것은 서로 다른 약국이라 하나를 버리면 실제 약국이 사라진다.
 */
internal fun uniqueIds(list: List<Pharmacy>): List<Pharmacy> {
    val seen = HashMap<String, Int>()
    return list.map { p ->
        val n = (seen[p.id] ?: 0) + 1
        seen[p.id] = n
        if (n == 1) p else p.copy(id = "${p.id}~$n")
    }
}

fun region(body: String): List<Pharmacy> {
    val o = envelope(body, "pharmacies")
    val arr = o.getJSONArray("pharmacies")
    return uniqueIds((0 until arr.length()).map { pharmacy(arr.getJSONObject(it)) })
}

화면이 아니라 파싱 단계에 둔 것이 요점입니다. 키 중복을 LazyColumn 앞에서만 막으면 지도 마커나 즐겨찾기처럼 같은 id를 쓰는 다른 곳은 여전히 겹친 값을 받습니다. 받아 오는 순간 한 번 고유하게 만들어 두면 그 뒤로는 어디서 쓰든 같습니다.

흔히 보이는 해법은 distinctBy { it.id }로 중복을 지우는 것입니다. 이 경우에는 틀린 답이었습니다. 겹친 두 레코드는 이름도 주소도 다른 약국이었고, 하나를 지우면 실제로 문을 연 약국이 목록에서 사라집니다. 첫 번째는 원래 id를 그대로 두었는데, 즐겨찾기 키가 바뀌지 않게 하려는 것입니다.

같은 자리, 다른 판단 — 지역 코드는 지운다

이틀 뒤 같은 패턴이 남은 곳을 찾다가 지역 목록도 지역 코드를 키로 쓰는 것을 봤습니다. 거기서는 반대로 앞엣것만 남기도록 했습니다. 이건 실제 사고가 난 곳이 아니라 예방으로 넣은 것입니다.

// 같은 지역 코드가 두 번 오면 앞엣것만 쓴다. 코드는 지역 목록의 LazyColumn key 라,
// 겹치면 약국 목록이 0.5.1 에서 죽은 것과 같은 자리에서 죽는다.
return DataIndex(o.getInt("schema"), o.optString("generated_at"), regions.distinctBy { it.code })
키겹친 두 줄은처리이유
약국 id서로 다른 약국뒤엣것에 ~2 꼬리지우면 실제 약국이 사라진다
지역 코드같은 지역앞엣것만 남김코드가 파일 선택·저장된 지역의 키라 이름을 바꾸면 조회가 끊긴다. 버려도 잃는 것이 없다

중복을 어떻게 처리할지는 키가 아니라 겹친 두 줄이 같은 것인지가 정합니다. 둘을 같은 함수로 묶지 않은 이유가 이것입니다.

확인 방법

단위 테스트 — 실제 사고 모양 그대로

서로 다른 약국 셋에 같은 id를 주고, 셋이 다 남는지와 id가 갈리는지를 봅니다. 레코드를 만드는 도우미 함수는 줄였습니다.

// 2026-10-06 실제 사고 — 서로 다른 약국 셋이 같은 id 로 왔고 목록이 죽었다.
@Test fun duplicate_ids_are_kept_but_made_unique() {
    val ps = Parse.region(region(rec("삼성중앙약국"), rec("압구정굿모닝약국"), rec("한강바로약국"), record))
    assertEquals(4, ps.size)
    assertEquals(4, ps.map { it.id }.toSet().size)
    assertEquals("L033084000019", ps[0].id)   // 첫 번째는 그대로 — 즐겨찾기 키가 안 바뀐다
    assertEquals("C1110651", ps[3].id)        // 안 겹친 것은 건드리지 않는다
}

수집 스크립트 쪽에도 끝 12자리가 같고 자치단체 자리만 다른 두 관리번호가 서로 다른 id를 받는지, 가드가 중복을 실패로 내는지를 테스트로 박아 두었습니다.

실기기 — 겹친 자리까지 직접 간다

릴리스 빌드로 서울 강남구를 고른 뒤 '전체' 545곳을 끝까지 스크롤했습니다. 죽지 않았고, 맨 아래 운영시간 없는 약국 하나를 열어 즐겨찾기에 담은 뒤 즐겨찾기 1건으로 나오는 것까지 봤습니다. 이 확인은 이후 배포 때마다 같은 절차로 다시 돌립니다.

이미 깔린 옛 버전

고친 0.5.2가 나가도 0.5.1을 쓰는 사람은 남습니다. 그래서 다음 날 원격 설정으로 최소 버전코드를 고친 버전으로 올려, 옛 버전을 연 사용자에게 업데이트 안내가 뜨게 했습니다. 버전코드만 15로 바꾼 빌드로 안내가 뜨는 것, 16에서는 안 뜨는 것을 실기기로 대조했습니다. 닫을 수 있는 안내라 강제는 아닙니다.

자주 묻는 것

key를 아예 빼면 이 크래시는 안 나지 않나요?

안 납니다. 키를 주지 않으면 위치(인덱스)로 항목을 구분하니까요. 대신 목록 순서가 바뀔 때 항목 상태가 엉뚱한 줄로 옮겨 갈 수 있습니다. 이 앱처럼 30초마다 목록을 다시 계산하는 화면에서는 키를 빼는 게 증상을 덮는 것에 가깝다고 봤고, 키는 그대로 두고 키가 고유해지게 고쳤습니다.

key = { "${it.id}-$index" } 처럼 인덱스를 섞으면요?

크래시는 막지만 키가 위치에 묶여 키를 쓰는 의미가 반쯤 사라집니다. 더 큰 문제는 중복이 생겼다는 사실이 아무 데도 남지 않는다는 점입니다. 저는 데이터 쪽 가드에서 중복을 발행 실패로 드러내고, 앱 쪽은 그래도 새어 들어온 것만 조용히 받아 내도록 나눴습니다.

서버 데이터를 믿지 말라는 얘기인가요?

제 경우는 데이터를 만드는 쪽도 저였습니다. 그래도 터졌습니다. 앱 배포와 데이터 갱신의 주기가 다르면, 앱이 의존하는 전제(id는 고유하다)는 앱 바깥에서 깨질 수 있습니다. 그 전제를 데이터 쪽에서 검사하고, 앱이 받는 지점에서 한 번 더 막는 것이 이번에 얻은 결론입니다.

LazyRow나 LazyVerticalGrid도 같은가요?

메시지에 LazyColumn/Row가 함께 적혀 있듯이 키를 받는 Lazy 목록은 같은 규칙을 따릅니다. 제가 직접 겪은 것은 LazyColumn 두 곳(약국 목록, 지역 목록)입니다.

728x90
반응형
LIST
728x90
반응형
SMALL

애드몹 광고 로드 실패를 기록으로 모아 보면, 앱 코드를 아무리 고쳐도 사라지지 않는 문구가 꽤 섞여 있습니다. 기기의 WebView 상태, 사용자의 통신, 광고 서버의 응답에서 나온 것들입니다. 이걸 전부 앱의 실패로 세면 정작 손봐야 할 결함이 그 아래에 묻힙니다. 반대로 계정이 멈춘 것 같은 큰 사건은 재고 없음과 같은 코드로 오기 때문에, 코드 번호가 아니라 문구로 갈라야 합니다.

증상 — 실패 목록이 길어서 읽을 수가 없다

광고 로드 콜백(onAdFailedToLoad)에서 받은 LoadAdError의 코드와 메시지를 그대로 기록해 두면 이런 줄이 쌓입니다.

banner_load_failed        code=0 Unable to obtain a JavascriptEngine
interstitial_load_failed  code=0 Unable to obtain a JavascriptEngine
banner_load_failed        code=3 Received error HTTP response code: 400
banner_load_failed        code=0 Error while connecting to ad server: Unable to resolve host ...
interstitial_load_failed  code=0 Internal error.
banner_load_failed        code=3 No fill.

처음 보면 전부 고쳐야 할 오류처럼 보입니다. 저는 여러 앱의 이런 기록을 매일 모아 메일로 받는데, 2026-08-25 하루에 1,207건이 실렸고 그중 사람이 손댈 수 있는 것은 두 줄뿐이었습니다. 그 두 줄은 목록 맨 밑에 있었습니다. 할 일이 없는 줄은 그냥 쓸모없는 게 아니라, 할 일이 있는 줄을 가려서 해롭습니다.

문구별 분류 — 원인이 어느 쪽에 있나

위 문구들을 원인이 있는 쪽으로 나누면 이렇습니다. 같은 코드 안에 성격이 다른 문구가 함께 들어 있다는 점을 먼저 봐 주세요.

문구코드원인 쪽앱에서 할 일
Unable to obtain a JavascriptEngine0기기(WebView)없음. 집계에서 접는다
Error while connecting to ad server: Unable to resolve host0통신(기기가 망에 없음)없음. 접는다
Network error2통신없음. 접는다
No fill.3광고 서버(줄 광고가 없음)없음. 접는다
Received error HTTP response code: 4003광고 서버(요청 거절)날짜와 기기 수를 본 뒤 기한을 두고 접는다
Internal error.0광고 서버 쪽 일시 오류. 계정 정지 때도 온다날짜와 기기 수를 본 뒤 기한을 두고 접는다
Publisher data not found3계정접지 않는다. 콘솔을 연다

Unable to obtain a JavascriptEngine

광고 SDK가 광고를 그릴 WebView 쪽 자바스크립트 엔진을 얻지 못했다는 뜻으로 읽힙니다. 기기의 WebView 상태에 달린 문제라 제 앱에서는 재현도 수정도 할 수 없었습니다. SDK 안에서 정확히 어떤 조건에 이 문구가 나오는지는 확인하지 못했고, 그래서 제 집계에서는 "기기 환경(WebView 없음 등)"이라는 한 갈래로만 분류합니다.

기기 쪽 문제라고 본 근거는 분포입니다. 한 앱의 최근 10일 광고 실패 기록에서 이 문구는 기기 3대에서만 나왔고, 배너와 전면이 같은 기기에서 같은 건수로 짝지어 났습니다. 광고 형식과 무관하게 그 기기에서는 광고가 통째로 안 되고, 나머지 기기에서는 이 문구가 한 번도 없었다는 뜻입니다. 앱 코드나 광고 단위 설정이 원인이면 이렇게 기기 몇 대에만 갇히지 않습니다.

Unable to resolve host 와 Network error

둘 다 사용자의 통신 상태입니다. 다만 앞의 것은 코드 2(네트워크 오류)가 아니라 코드 0으로 옵니다. 코드 2만 통신 문제로 걸러 두면 이 문구가 "내부 오류"로 남습니다. 기기가 인터넷을 잃으면 광고만 실패하는 게 아니라 같은 기기에서 같은 날 다른 API 호출도 함께 실패하므로, 광고 쪽만 접고 나머지를 앱의 실패로 올리면 한 사건을 반만 접은 셈이 됩니다.

No fill 과 Publisher data not found

No fill은 애드몹이 줄 광고가 없었다는 뜻이고, 사용자가 적은 앱에서는 매일 납니다. 이걸 앱의 잘못으로 세면 매일 헛경보가 옵니다.

문제는 계정이 멈췄을 때도 같은 코드 3이 온다는 점입니다. 2026-08-24 계정이 정지된 상태에서 실기기에 찍힌 문구가 code=3 Publisher data not found였습니다. 코드만 보고 "3이면 재고 없음"으로 분류해 두었더니, 계정이 통째로 멈춘 날에도 감시가 조용히 넘어가는 구조였습니다. 가장 크게 알려야 할 사건이 가장 조용한 자리로 가고 있던 것입니다.

가르는 방법 — 날짜 × 기기 수

HTTP 400과 Internal error는 문구만으로는 판단이 안 됩니다. 광고 단위를 지웠거나 앱 ID가 어긋난 설정 문제일 수도 있기 때문입니다. 이럴 때는 실패 기록을 날짜와 기기로 나눠 봅니다.

분포읽는 법
하루에 기기 한두 대, 같은 날 다른 기기에는 광고 노출이 잡힌다그 기기의 요청만 거절된 것. 설정 문제가 아니다
여러 기기에서 며칠째 이어지고 노출이 같이 줄어든다설정 문제 의심. 광고 단위·앱 ID를 확인한다
여러 앱에서 같은 날 동시에 난다계정 단위 사건 의심

실제로 이렇게 판정했습니다. 한 앱이 Received error HTTP response code: 400으로 나흘 연속 실패 목록에 올랐는데, 날짜별로 나누니 10월 3일에 기기 한 대(2건), 10월 5일에 기기 한 대(13건)였습니다. 10월 2일에는 500도 1건 있었습니다. 같은 날 광고 노출 이벤트는 정상으로 잡혔고, 배포한 바이너리 안의 애드몹 앱 ID와 광고 단위가 같은 게시자 것으로 맞는지도 확인했습니다. 설정이 틀렸다면 모든 기기에서 매일 실패했을 텐데 하루 한 대였으니, 광고 서버가 그 기기의 요청을 거절한 것으로 보고 접었습니다. 그 뒤로 이 문구는 0건입니다.

Internal error는 같은 방법으로 정반대 결론이 난 적이 있습니다. 계정이 정지된 8월 23·24일 이틀 동안 이 문구가 앱 5개에서 동시에 났습니다. 반면 10월 5일에 다른 앱에서 난 3건은 하루, 기기 2대였고 다음 날 노출이 돌아왔습니다. 문구는 같은데 앞의 것은 계정 사건이고 뒤의 것은 일시 오류입니다. 문구가 아니라 분포가 둘을 갈랐습니다.

기기 한 대의 건수는 크게 보입니다.
한 대가 하루에 13건을 내면 목록에서는 큰 사고처럼 보입니다. 건수 말고 기기 수를 세어야 합니다.

코드 — 문구로 분류하기

앱 쪽: 코드와 메시지를 함께 본다

여러 앱이 같이 쓰는 광고 공통 코드에서 줄인 것입니다. 코드 0·2·3은 앱에서 고칠 수 없는 쪽으로 두되, 계정 문구가 있으면 코드가 3이어도 따로 건집니다.

private const val CODE_INTERNAL_ERROR = 0
private const val CODE_NETWORK_ERROR = 2
private const val CODE_NO_FILL = 3
private const val MSG_PUBLISHER_DATA_NOT_FOUND = "Publisher data not found"

fun isAccountProblem(message: String?): Boolean =
    message?.contains(MSG_PUBLISHER_DATA_NOT_FOUND, ignoreCase = true) == true

fun isOurFaultCode(code: Int, message: String? = null): Boolean {
    if (isAccountProblem(message)) return true      // 코드가 3이어도 계정 문제
    return code != CODE_NO_FILL &&
           code != CODE_NETWORK_ERROR &&
           code != CODE_INTERNAL_ERROR
}

fun loadFailed(kind: String, error: LoadAdError) {
    val accountProblem = isAccountProblem(error.message)
    recordIssue(
        where = "ads",
        kind = if (accountProblem) "ad_account_problem" else kind,
        detail = "code=${error.code} ${error.message}",
        ourFault = accountProblem || isOurFaultCode(error.code, error.message),
    )
}

계정 문제일 때 기록 종류를 ad_account_problem 하나로 바꾸는 것이 요점입니다. 배너·전면·보상형 각각의 실패로 흩어 두면 "배너가 좀 실패하네"로 보이지만, 실제로는 계정이 멈춘 것이라 대응이 전혀 다릅니다. 판정 함수가 LoadAdError 대신 숫자와 문자열을 받는 것은 단위 테스트로 고정하기 위해서입니다.

@Test
fun `계정 문제는 code가 3이어도 우리 잘못이다`() {
    assertTrue(isOurFaultCode(3, "Publisher data not found"))
    assertTrue(isOurFaultCode(3, "Error: publisher data not found for this app"))

    assertFalse(isOurFaultCode(3, null))            // 문구 없는 3 은 평범한 재고 없음
}

집계 쪽: 문구를 원인으로 바꾸고, 원인으로 접는다

기록을 읽는 쪽(파이썬)에서는 먼저 영어 원문을 "어느 쪽 탓인지"가 붙은 짧은 말로 바꾸고(DETAIL_NOISE), 그 말이 들어 있는 줄은 개별로 싣지 않습니다. 원인이 앱 밖으로 확정된 것은 기한 없이(ENV_CAUSES), 조사해서 원인을 아는 사건은 기간을 정해(KNOWN_INCIDENTS) 접습니다.

import re
from datetime import date

DETAIL_NOISE = [
    (re.compile(r"Unable to obtain a JavascriptEngine"),
     "기기의 WebView 를 못 씀 — 기기 탓"),
    (re.compile(r"Error while connecting to ad server.*"),
     "광고서버 접속 실패 — 통신 탓"),
    (re.compile(r"(?:UnknownHostException.*|Unable to resolve host.*)"),
     "이름 해석 실패(기기가 망에 없음) — 통신 탓"),
]

ENV_CAUSES = {
    "기기 탓": "기기 환경(WebView 없음 등)",
    "통신 탓": "사용자 통신 상태",
    "Network error": "사용자 통신 상태",
    "No fill": "광고 재고 없음",
}

KNOWN_INCIDENTS = (
    {
        "since": date(2026, 10, 1),
        "until": date(2026, 11, 5),
        "label": "광고서버 거절·일시 오류 — 단위·계정 정상 확인",
        "detail_has": ("Received error HTTP response code",
                       "code=0 Internal error"),
    },
)

def muted(text: str, oldest: date) -> str | None:
    """접을 것이면 접는 이유를 돌려준다."""
    for key, why in ENV_CAUSES.items():
        if key in text:
            return why
    for inc in KNOWN_INCIDENTS:
        if inc["since"] <= oldest <= inc["until"] and \
           any(s in text for s in inc["detail_has"]):
            return inc["label"]
    return None

세 가지를 지켰습니다.

  • 접은 것은 버리지 않습니다. 접는 이유를 문자열로 돌려받아, 이유별 건수를 맨 아래 한 줄로 남깁니다. 조용히 버리면 나중에 "왜 안 보이지"로 헤맵니다.
  • 판단이 필요했던 문구에는 기한을 둡니다. HTTP 400과 Internal error는 기한이 지나면 저절로 다시 올라옵니다. 그 전에도 건수가 하루 수십 건, 여러 기기로 번지면 맨 아래 건수 한 줄이 커지는 것으로 드러납니다.
  • 좁게 잡습니다. Internal error는 code=0까지 붙여서 맞춥니다. 낱말만으로 잡으면 무관한 새 오류까지 삼킬 수 있습니다. Publisher data not found는 어느 목록에도 넣지 않았습니다.

오류 코드(0·1·2·3·8)별로 무엇을 고쳐야 하는지는 애드몹 광고가 안 나올 때 — 오류 코드별 해결에, 계정이 정지됐던 경위는 애드몹 계정 정지 글에 따로 적었습니다. 이 글은 고칠 수 없는 문구를 가려내 집계에서 빼는 쪽만 다뤘습니다.

정리

  • Unable to obtain a JavascriptEngine은 기기의 WebView 쪽 문제로 읽힙니다. 기기 몇 대에서만, 배너와 전면이 짝지어 납니다.
  • Unable to resolve host는 통신 문제인데 코드 0으로 옵니다. 코드 2만 걸러서는 안 잡힙니다.
  • No fill과 Publisher data not found는 같은 코드 3입니다. 앞은 접고 뒤는 반드시 울리게 합니다.
  • HTTP 400·Internal error는 날짜와 기기 수로 봅니다. 하루 한 대이고 같은 날 노출이 정상이면 설정 문제가 아닙니다.
  • 접을 때는 이유별 건수를 남기고, 판단이 들어간 항목에는 기한을 둡니다.

자주 묻는 것

코드 0이면 전부 무시해도 되나요?

아닙니다. 코드 0에는 기기의 WebView 문제, 통신 두절, 광고 서버의 일시 오류가 함께 들어 있고, 계정이 정지됐을 때도 Internal error가 코드 0으로 왔습니다. 코드로는 앱의 잘못이 아니라는 것까지만 알 수 있고, 계정 단위 사건인지는 여러 앱·여러 기기에서 같은 날 났는지를 봐야 갈립니다.

HTTP 400이 여러 기기에서 매일 나오면요?

그때는 접어 둔 것을 풀고 설정을 봐야 합니다. 광고 단위가 삭제됐거나 앱에 들어간 애드몹 앱 ID가 어긋났을 수 있습니다. 하루 한 대라는 분포가 "설정 문제가 아니다"의 근거였으므로, 분포가 달라지면 결론도 달라집니다.

No fill을 앱의 실패로 세면 안 되나요?

세어도 되지만 사용자가 적은 앱에서는 매일 나는 값이라 경보로 쓰면 매일 울립니다. 계정 문구가 없는 코드 3은 평범한 재고 없음으로 두고, 건수 추이만 따로 보는 편이 낫습니다.

접어 두면 진짜 문제를 놓치지 않나요?

놓칠 수 있어서 장치를 둡니다. 접은 건수를 이유별로 한 줄 남기는 것, 판단이 들어간 항목에 기한을 두는 것, 계정 문구는 절대 접지 않는 것입니다. 접힌 건수 한 줄이 갑자기 커지면 그게 다시 들여다볼 신호입니다.

728x90
반응형
LIST

+ Recent posts