[100턴 구조 읽기 6] 장애가 바꾼 설계

/// 구버전의 구조적 문제 (브라질 첫 API 실패 증상의 원인 후보):
///  1. UniRx 외부 Timeout(60초)과 내부 재시도 루프(최대 3회 × 60초)가 서로 경쟁 —
///     첫 시도가 지연되면(장거리 라우팅/TLS 스톨) 재시도가 진행 중인데도 60초에 전체가
///     에러로 종료됐다. 사용자는 60초를 기다린 뒤 실패를 봤다.
///  2. 시도별 타임아웃이 60초라 연결이 스톨된 경우 빠른 재시도가 불가능했다.
///  3. WebGL(IL2CPP)에서 UniRx 스케줄러/스트리핑 이슈 가능성.
///
/// 새 설계:
///  - 외부 타이머 없음. 시도별 타임아웃 에스컬레이션(15→25→40초) + 백오프(1→2초).
///    스톨된 연결은 15초에 끊고 새 연결로 재시도 → 첫 연결 불안정 환경에서 회복 빠름.
///  - 서버가 응답한 4xx는 재시도하지 않음(중복 처리 방지). 연결 실패/타임아웃/5xx만 재시도.
///  - internetReachability는 차단하지 않고 경고만 남김
///    (WebGL의 navigator.onLine 오탐이 정상 기기를 전부 튕겨낼 수 있음).
///  - 진단 로그 강화: URL, 시도 횟수, HTTP 상태, 에러 원문을 남겨 지역 이슈 추적 가능.

// 시도별 타임아웃(초)과 재시도 전 대기(초). 배열 길이 = 최대 시도 횟수.
private static readonly int[] ATTEMPT_TIMEOUTS = { 15, 25, 40 };
private static readonly float[] RETRY_DELAYS = { 1.0f, 2.0f };

for (int attempt = 0; attempt < ATTEMPT_TIMEOUTS.Length; attempt++)
{
    using (UnityWebRequest request = requestFactory())
    {
        request.timeout = ATTEMPT_TIMEOUTS[attempt];

        yield return request.SendWebRequest();

/// <summary>부팅 직후 프레임워크에 라벨 제공자 등록</summary>
[UnityEngine.RuntimeInitializeOnLoadMethod(UnityEngine.RuntimeInitializeLoadType.BeforeSceneLoad)]
private static void Register()
{
    ElGame.ElAddressables.SceneLabelProvider = GetLabelsForScene;
    ElGame.ElAddressables.BootLabelProvider = () => BootLabels;
}

/// 설계:
///   - 번들명(예: prefab^effect) = Addressables 그룹명 = 라벨. 기존 큐레이션 보존.
///   - scenes 번들은 씬별 개별 번들로 분리(PackSeparately) — 102MB 일괄 다운로드 해소.
///   - 일반 에셋 주소 = "번들명/에셋명(소문자)" — 런타임 ElAddressables.Load가 같은
///     규칙으로 키를 계산하므로 기존 ElCore.Load 경로 문자열이 그대로 동작한다.
///   - 씬 주소 = 씬 이름 (ElBehaviour.LoadScene(sceneName)와 호환).

if (assetCache.TryGetValue(key, out var obj)) return obj;

// 미스 원인 자가진단 — 키당 1회만 보고
if (logMissing && reportedMisses.Add(key))
{
    string label = key.Split('/')[0];
    if (loadedLabels.Contains(label))
    {
        Debug.LogErrorFormat(
            "[ElAddressables] 캐시 미스: {0} — 라벨 '{1}'은 프리페치됐지만 이 키가 없음. " +
            "에셋이 그룹에 미등록(Setup Groups 재실행 필요)이거나 원본에 파일이 없는 선택적 로드일 수 있음",
            path, label);
    }
    else
    {
        Debug.LogErrorFormat(
            "[ElAddressables] 캐시 미스: {0} — 라벨 '{1}'이 프리페치되지 않음. " +
            "TDAddressablesConfig의 이 씬 라벨에 추가 필요. (현재 로드된 라벨: {2})",
            path, label, loadedLabels.Count > 0 ? string.Join(", ", loadedLabels) : "없음");
    }
}
return null;