R 초보 오류 해결 순서: 메시지 읽기부터 최소 예제까지

R 초보 오류는 메시지를 전부 이해하지 못해도 해결할 수 있습니다. 방금 실행한 코드에서 오류가 시작된 함수를 찾고 입력 객체의 구조를 확인하면 조사할 범위가 줄어듭니다.

가장 먼저 코드를 짧게 줄이고 같은 오류가 다시 나는지 확인합니다. 패키지 재설치나 프로그램 초기화는 원인이 확인된 뒤에 해야 불필요한 변경을 피할 수 있습니다.

1단계: 오류 직전의 한 줄을 분리합니다

긴 파이프나 반복문에서 오류가 났다면 각 단계를 한 줄씩 실행합니다. 어느 단계까지 정상인지 확인하면 조사 범위가 크게 줄어듭니다.

result <- raw_data |>
  filter(amount > 0) |>
  summarise(total = sum(amount))

위 코드는 raw_data, filter() 결과, summarise() 순으로 나누어 확인합니다. 오류 메시지를 복사할 때는 마지막 줄뿐 아니라 호출 흐름 전체를 보관합니다.

객체를 찾을 수 없다는 오류

object not found는 이름 오타, 실행 순서, 대소문자 차이에서 자주 발생합니다. ls()로 현재 환경의 객체를 보고 코드에 적힌 이름과 정확히 비교합니다.

ls()
exists("sales")

함수를 찾을 수 없다는 오류

could not find function은 패키지를 설치만 하고 불러오지 않았을 때 흔합니다. library(dplyr)를 실행하거나 dplyr::filter()처럼 출처를 명시합니다.

패키지 설치 오류와 함수 로드 오류는 구분해야 합니다. 설치 로그에 실패가 있었다면 library()를 반복하기 전에 설치 원인을 확인합니다.

파일을 찾을 수 없다는 오류

getwd()
list.files("data")
file.exists("data/sales.csv")

파일 탐색기에서 보이는 위치와 R의 현재 작업 폴더는 다를 수 있습니다. 절대 경로로 임시 해결하기보다 프로젝트 폴더를 만들고 상대 경로를 사용하는 편이 안전합니다.

자료형과 열 이름 오류

숫자 계산에서 문자가 섞였거나 존재하지 않는 열을 선택하면 예상 밖의 메시지가 나옵니다. str(), names(), unique()로 입력 구조와 실제 값을 확인합니다.

str(sales)
names(sales)
unique(sales$status)

열 이름 앞뒤의 공백과 한글 인코딩도 확인합니다. 눈으로 비슷해 보이는 이름을 다시 입력하기보다 names() 결과에서 복사하는 것이 정확합니다.

괄호·따옴표·쉼표 오류

콘솔 프롬프트가 >가 아니라 +로 바뀌었다면 괄호나 따옴표가 닫히지 않았을 가능성이 큽니다. RStudio·Positron에서는 Esc, 터미널에서는 Ctrl+C로 입력을 취소한 뒤 코드 편집기에서 짝을 맞춥니다.

길이 불일치와 결측치

데이터프레임 열은 길이가 맞아야 하며, NA가 포함된 계산은 결과도 NA가 될 수 있습니다. 먼저 length()와 sum(is.na())로 사실을 확인합니다.

length(sales$amount)
sum(is.na(sales$amount))
mean(sales$amount, na.rm = TRUE)

최소 재현 예제 만들기

원본 데이터 전체 대신 오류가 나는 열과 5~10개 행만 남깁니다. 다른 사람이 복사해 실행할 수 있도록 패키지 로드, 작은 데이터, 오류 코드 순으로 정리합니다.

traceback()은 오류 직후 호출 흐름을 보여 줍니다. 도움을 요청할 때는 오류 전문, 최소 코드, str()과 sessionInfo() 결과를 함께 제공하면 해결 가능성이 높아집니다.

기초 문법 때문에 생긴 오류라면 R 기초 공략집 — 데이터 분석을 위한 R 프로그래밍 입문의 목차에서 관련 단원을 찾아 짧은 예제부터 다시 실행해 볼 수 있습니다.