How-To Guide on Advanced Beginner

Implicit/Given 디버깅

d8lzz1gpw@mozmail.com (kimbenji) — Fri, 16 Jan 2026 00:00:00 +0000

컴파일러가 암시적 값을 찾지 못할 때 원인을 진단하고 해결하는 방법을 안내합니다.

소요 시간: 약 10-15분

TL;DR

Scala 2: -Xlog-implicits 플래그로 검색 과정 확인

Scala 3: 컴파일러 메시지가 더 명확하며, import 제안도 제공

공통: 스코프에 암시적 값이 있는지, 타입이 정확히 일치하는지 확인

이 가이드가 해결하는 문제#

다음과 같은 컴파일 에러가 발생할 때 이 가이드를 사용하세요:

Scala 2

could not find implicit value for parameter ord: Ordering[MyClass]

또는

ambiguous implicit values

Scala 3

No given instance of type Ordering[MyClass] was found

또는

Future 에러 처리

d8lzz1gpw@mozmail.com (kimbenji) — Fri, 16 Jan 2026 00:00:00 +0000

비동기 코드에서 예외를 안전하게 처리하고 디버깅하는 방법을 안내합니다.

소요 시간: 약 15-20분

TL;DR

recover/recoverWith: 특정 예외를 처리하고 대체값 반환

transform: 성공/실패 모두 변환

onComplete: 부수 효과 (로깅 등)에만 사용

절대 하지 말 것: Await.result로 예외를 동기적으로 던지기

이 가이드가 해결하는 문제#

다음 상황에서 이 가이드를 사용하세요:

Future에서 발생한 예외가 조용히 사라지는 경우
비동기 코드의 에러를 어떻게 처리해야 할지 모를 때
recover, recoverWith, transform 중 어떤 것을 사용해야 할지 결정이 필요할 때

증상#

import scala.concurrent.Future
import scala.concurrent.ExecutionContext.Implicits.global

val future = Future {
 throw new RuntimeException("Something went wrong")
}
// 프로그램은 정상 종료되지만, 예외는 어디로 갔을까?

이 가이드가 다루지 않는 것#

Future의 기본 개념: 동시성 개념 문서를 참조하세요
Cats Effect IO / ZIO의 에러 처리: 해당 라이브러리 문서를 참조하세요
액터 시스템(Akka)의 에러 처리: Akka 문서를 참조하세요

시작하기 전에#

다음 환경이 준비되어 있는지 확인하세요:

타입 에러 디버깅

d8lzz1gpw@mozmail.com (kimbenji) — Mon, 23 Mar 2026 00:00:00 +0000

복잡한 타입 에러 메시지를 해독하고 해결하는 방법을 안내합니다.

소요 시간: 약 15-20분

TL;DR

Type Mismatch: 기대 타입과 실제 타입을 비교하여 어디서 불일치가 발생했는지 확인

Bounds 위반: 타입 파라미터의 상한/하한 제약 조건 확인

Variance 문제: 공변/반공변 위치에 올바른 타입이 있는지 확인

splain 플러그인: 복잡한 타입 에러를 읽기 쉬운 형태로 변환

이 가이드가 해결하는 문제#

다음과 같은 컴파일 에러가 발생할 때 이 가이드를 사용하세요:

type mismatch;
 found : List[String]
 required: List[Int]

type arguments [Dog] do not conform to method process's
type parameter bounds [A <: Animal with Serializable]

covariant type A occurs in contravariant position in type A => Unit

이 가이드가 다루지 않는 것#

타입 시스템의 기초 개념: 타입 시스템 개념 문서를 참조하세요
암시적 값 관련 에러: Implicit/Given 디버깅을 참조하세요
매크로/리플렉션 관련 에러: 해당 라이브러리 문서를 참조하세요

시작하기 전에#

다음 환경이 준비되어 있는지 확인하세요:

sbt 의존성 충돌 해결

d8lzz1gpw@mozmail.com (kimbenji) — Mon, 23 Mar 2026 00:00:00 +0000

라이브러리 버전 충돌을 진단하고 해결하는 방법을 안내합니다.

소요 시간: 약 15-20분

TL;DR

증상: 컴파일은 성공하지만 런타임에 NoSuchMethodError, ClassNotFoundException 발생

진단: sbt dependencyTree로 충돌 라이브러리 확인

해결: exclude, dependencyOverrides, force() 활용

예방: eviction 경고를 무시하지 말 것

이 가이드가 해결하는 문제#

다음 상황에서 이 가이드를 사용하세요:

컴파일은 성공하지만 런타임에 NoSuchMethodError가 발생하는 경우
ClassNotFoundException이 발생하지만 라이브러리가 분명히 있는 경우
sbt 빌드 시 eviction 경고가 출력되는 경우
여러 라이브러리가 같은 의존성의 다른 버전을 요구하는 경우

증상#

# 컴파일은 성공하지만 실행 시 에러
$ sbt run
java.lang.NoSuchMethodError: 'void com.google.common.collect.ImmutableMap.forEach()'

# 또는 클래스를 찾지 못함
$ sbt run
java.lang.ClassNotFoundException: org.apache.commons.lang3.StringUtils

이 가이드가 다루지 않는 것#

sbt 기본 사용법: sbt 공식 문서를 참조하세요
Maven/Gradle 의존성 관리: 해당 빌드 도구 문서를 참조하세요
Scala 바이너리 호환성: Scala 버전 간 호환성 문제는 별도 주제입니다

시작하기 전에#

다음 환경이 준비되어 있는지 확인하세요:

성능 프로파일링

d8lzz1gpw@mozmail.com (kimbenji) — Mon, 23 Mar 2026 00:00:00 +0000

Scala 애플리케이션의 성능 병목을 찾고 최적화하는 방법을 안내합니다.

소요 시간: 약 20-25분

TL;DR

CPU 프로파일링: JFR(Java Flight Recorder)로 핫스팟 식별

메모리 분석: 힙 덤프를 VisualVM 또는 MAT로 분석

컬렉션 선택: 용도에 맞는 컬렉션을 사용하면 성능이 크게 달라짐

최적화 기법: @specialized, @tailrec, 박싱 회피

이 가이드가 해결하는 문제#

다음 상황에서 이 가이드를 사용하세요:

애플리케이션의 응답 시간이 갑자기 느려진 경우
메모리 사용량이 지속적으로 증가하는 경우 (메모리 누수 의심)
어떤 컬렉션을 사용해야 할지 성능 관점에서 결정이 필요한 경우
GC 일시 정지가 빈번하게 발생하는 경우

이 가이드가 다루지 않는 것#

JVM 튜닝 (GC 옵션 등): JVM 공식 문서를 참조하세요
분산 시스템 성능 최적화: 별도 주제입니다
Cats Effect / ZIO의 성능 최적화: 해당 라이브러리 문서를 참조하세요

시작하기 전에#

다음 환경이 준비되어 있는지 확인하세요: