React Native Crash와 ANR: 앱 종료와 무응답을 어떤 증거로 나누는가

앱 process 종료      Android exit reason / Apple crash·jetsam 보고서
Android 무응답       ANR 범주 / 당시 trace와 관련 스레드
iOS 무응답           hang 진단 / responsiveness 보고서
JavaScript 지연      JS heartbeat 간격 / native UI가 계속 움직였는지

import React, { useState } from 'react'
import { Button, SafeAreaView, StyleSheet, Text, View } from 'react-native'
 
const USE_PLATFORM_EVIDENCE = false
 
type AndroidExitReason =
  | 'REASON_CRASH'
  | 'REASON_CRASH_NATIVE'
  | 'REASON_ANR'
  | 'REASON_USER_REQUESTED'
  | null
 
type AppleDiagnostic = 'crash' | 'hang' | 'jetsam' | null
 
type SharedEvidence = {
  id: string
  reportedFrozen: boolean
  processExited: boolean
  jsHeartbeatGapMs: number
  nativeScrollContinued: boolean
}
 
type AndroidEvidence = SharedEvidence & {
  platform: 'android'
  androidExitReason: AndroidExitReason
  androidAnrTraceAvailable: boolean
}
 
type AppleEvidence = SharedEvidence & {
  platform: 'ios'
  appleDiagnostic: AppleDiagnostic
}
 
type EvidenceCase = AndroidEvidence | AppleEvidence
 
type Classification =
  | 'crash'
  | 'android-anr'
  | 'ios-hang'
  | 'memory-termination'
  | 'other-termination'
  | 'js-thread-stall-symptom'
  | 'needs-platform-evidence'
 
type Result = {
  id: string
  classification: Classification
  evidence: string
}
 
const CASES: EvidenceCase[] = [
  {
    id: 'android-crash',
    platform: 'android',
    reportedFrozen: false,
    processExited: true,
    androidExitReason: 'REASON_CRASH',
    androidAnrTraceAvailable: false,
    jsHeartbeatGapMs: 80,
    nativeScrollContinued: false,
  },
  {
    id: 'android-anr-killed',
    platform: 'android',
    reportedFrozen: true,
    processExited: true,
    androidExitReason: 'REASON_ANR',
    androidAnrTraceAvailable: true,
    jsHeartbeatGapMs: 5200,
    nativeScrollContinued: false,
  },
  {
    id: 'react-native-js-stall',
    platform: 'android',
    reportedFrozen: true,
    processExited: false,
    androidExitReason: null,
    androidAnrTraceAvailable: false,
    jsHeartbeatGapMs: 4200,
    nativeScrollContinued: true,
  },
  {
    id: 'ios-hang',
    platform: 'ios',
    reportedFrozen: true,
    processExited: false,
    appleDiagnostic: 'hang',
    jsHeartbeatGapMs: 3600,
    nativeScrollContinued: false,
  },
]
 
function classifyFromSymptom(input: EvidenceCase): Result {
  if (input.processExited) {
    return {
      id: input.id,
      classification: 'crash',
      evidence: 'process 종료만 확인',
    }
  }
 
  if (input.reportedFrozen) {
    return {
      id: input.id,
      classification: 'android-anr',
      evidence: '사용자 무응답 신고만 확인',
    }
  }
 
  return {
    id: input.id,
    classification: 'needs-platform-evidence',
    evidence: '플랫폼 원본 없음',
  }
}
 
function classifyFromPlatformEvidence(input: EvidenceCase): Result {
  if (input.platform === 'android') {
    if (
      input.androidExitReason === 'REASON_CRASH' ||
      input.androidExitReason === 'REASON_CRASH_NATIVE'
    ) {
      return {
        id: input.id,
        classification: 'crash',
        evidence: input.androidExitReason,
      }
    }
 
    if (input.androidExitReason === 'REASON_ANR') {
      return {
        id: input.id,
        classification: 'android-anr',
        evidence: input.androidAnrTraceAvailable
          ? 'REASON_ANR + trace 있음'
          : 'REASON_ANR + trace 없음',
      }
    }
 
    if (input.processExited && input.androidExitReason !== null) {
      return {
        id: input.id,
        classification: 'other-termination',
        evidence: input.androidExitReason,
      }
    }
  }
 
  if (input.platform === 'ios' && input.appleDiagnostic === 'crash') {
    return { id: input.id, classification: 'crash', evidence: 'Apple crash' }
  }
 
  if (input.platform === 'ios' && input.appleDiagnostic === 'hang') {
    return { id: input.id, classification: 'ios-hang', evidence: 'Apple hang' }
  }
 
  if (input.platform === 'ios' && input.appleDiagnostic === 'jetsam') {
    return {
      id: input.id,
      classification: 'memory-termination',
      evidence: 'Apple jetsam',
    }
  }
 
  if (
    !input.processExited &&
    input.jsHeartbeatGapMs >= 3000 &&
    input.nativeScrollContinued
  ) {
    return {
      id: input.id,
      classification: 'js-thread-stall-symptom',
      evidence: `JS ${input.jsHeartbeatGapMs}ms / native scroll 계속`,
    }
  }
 
  return {
    id: input.id,
    classification: 'needs-platform-evidence',
    evidence: '운영체제 원본을 더 수집',
  }
}
 
export default function App() {
  const [results, setResults] = useState<Result[]>([])
 
  function runClassification() {
    const classify = USE_PLATFORM_EVIDENCE
      ? classifyFromPlatformEvidence
      : classifyFromSymptom
 
    setResults(CASES.map(classify))
  }
 
  return (
    <SafeAreaView style={styles.screen}>
      <Text style={styles.title}>Crash·ANR 증거 분류 fixture</Text>
      <Text>
        플랫폼 증거 사용: {USE_PLATFORM_EVIDENCE ? 'on' : 'off'}
      </Text>
      <Button title="4개 사례 분류" onPress={runClassification} />
 
      <View style={styles.results}>
        {results.map(result => (
          <View key={result.id} style={styles.row}>
            <Text>{result.id}</Text>
            <Text>분류: {result.classification}</Text>
            <Text>근거: {result.evidence}</Text>
          </View>
        ))}
      </View>
    </SafeAreaView>
  )
}
 
const styles = StyleSheet.create({
  screen: { flex: 1, padding: 16, gap: 12 },
  title: { fontSize: 22, fontWeight: '700' },
  results: { gap: 10 },
  row: { borderWidth: 1, borderColor: '#8A8A8A', padding: 10, gap: 4 },
})

android-crash          → crash
android-anr-killed     → crash
react-native-js-stall  → android-anr
ios-hang               → android-anr

const USE_PLATFORM_EVIDENCE = true

android-crash          → crash / REASON_CRASH
android-anr-killed     → android-anr / REASON_ANR + trace 있음
react-native-js-stall  → js-thread-stall-symptom / JS 4200ms / native scroll 계속
ios-hang               → ios-hang / Apple hang

1. timestamp와 reason으로 종료 사건을 식별
2. REASON_CRASH / REASON_CRASH_NATIVE / REASON_ANR을 다른 범주로 보존
3. reason이 ANR이면 trace stream을 추가 증거로 읽되 null 가능성 처리
4. 앱 버전·React Native 버전·기기·마지막 비민감 제품 행동과 연결
5. 같은 종료 사건을 다음 시작마다 중복 전송하지 않도록 사건 ID 저장

화면 입력 응답 제한      UI 스레드가 touch·key 입력 처리 중 무엇을 실행·대기했는가
broadcast 수신 제한      Android 사건을 받는 함수가 제때 끝났는가
service 시작 제한        화면에 보이지 않는 동안에도 운영체제가 시작할 수 있는 구성요소의 시작 함수가 제때 끝났는가
잠금 대기                한 작업만 자원에 들어가게 막는 잠금을 어느 스레드가 쥐고 있는가
느린 운영체제 호출       앱 스레드가 실제로 실행됐는지, Android 시스템 서비스가 느렸는가

공통 영향         terminated / unresponsive / degraded
플랫폼 원본       android-crash / android-anr / ios-crash / ios-hang / ios-jetsam
실행 경계         JavaScript / UI thread / 플랫폼 background 작업 / 운영체제
버전              app / React Native / platform SDK / 운영체제
사건 문맥         마지막 비민감 제품 단계 / attempt ID / timestamp
원본 증거 위치    Android cluster·trace / Apple 보고서·진단 기록

사용자 증상       사라짐·입력 지연·화면 정지를 원본 범주와 분리했는가
process 증거      이전 process 종료 여부와 종료 이유를 확인했는가
Android 원본      crash reason과 ANR reason·trace를 구분했는가
iOS 원본          crash·hang·jetsam 보고서를 구분했는가
스레드 증거       JavaScript와 UI 스레드 중 무엇이 실행·대기했는가
재현 환경         개발용 fixture·emulator·Simulator·실기기 범위를 적었는가
버전              앱·React Native·운영체제·기기·SDK를 기록했는가
개인정보           token·사용자 입력·전체 메모리를 수집하지 않는가
교정 검증         같은 플랫폼 원본 범주의 재현이 사라졌는가

문제       “화면이 멈췄다가 앱이 사라졌다”는 신고
오판       process 종료=crash, 화면 정지=Android ANR로 즉시 분류
실패       killed ANR은 crash로, JS stall과 iOS hang은 ANR로 잘못 저장
교정       Android exit reason·ANR trace, Apple crash·hang 원본부터 읽음
React Native 경계    JavaScript 실행 지연은 중요한 문맥이지만 ANR 단독 증거가 아님
Android    crash와 ANR을 분리하고 reason과 trace도 별도 필드로 보존
iOS        crash report·hang diagnostic·jetsam report를 분리
검증       가상 분류 규칙과 실제 플랫폼 진단 수집 범위를 구분
다음       25~27편에서 JavaScript·Android·iOS stack 위치를 복원