[Java] “그냥 for문 쓰면 안 돼요?” Java 순회 방식 제대로 알기

 

목차

 

“컬렉션에 데이터를 넣었는데, 어떻게 꺼내야 할지 모르겠어요.”
“for문 쓰다 갑자기 예외가 터졌는데 이유를 모르겠어요.”

 

Java를 처음 배우거나 실무에 들어온 초보 개발자들이 가장 자주 혼란스러워하는 것 중 하나가 컬렉션 순회 방식입니다.

Iterator, for-each, ListIterator, forEach(), Stream API까지… 도대체 뭐가 다르고, 언제 뭘 써야 할까요?

 

이번 글에서는 자바 컬렉션 순회의 모든 방식을 예제 코드 중심으로 비교하고, 실무에서 자주 터지는 예외 상황까지 알아보겠습니다.

---

✅ 왜 컬렉션 순회 방식이 이렇게 많을까?

Java는 꾸준히 발전해 오면서 개발자들의 요구와 기술 흐름에 맞춰 다양한 순회 방식을 도입해 왔습니다.

각 방식은 그 시점에서 불편함을 해소하거나 생산성을 높이기 위해 등장한 것이죠.

버전	기능	특징
Java 1.2	Iterator	안전한 삭제
Java 5	for-each	간결한 문법
Java 8	forEach(), Stream	함수형 프로그래밍 스타일

 

➡️ 모두 여전히 사용 가능하며, 각 방식은 상황에 맞춰 선택해야 최적의 코드 품질을 낼 수 있습니다.

---

🔹 Iterator

Iterator는 컬렉션의 요소를 순차적으로 탐색할 수 있는 표준 인터페이스입니다.

특히 순회 중 요소를 안전하게 제거할 수 있는 유일한 방법입니다.

List<String> items = new ArrayList<>(List.of("사과", "상한 바나나", "우유"));

Iterator<String> iterator = items.iterator();
while (iterator.hasNext()) {
    String item = iterator.next();
    if (item.contains("상한")) {
        iterator.remove();  // 안전한 제거!
    }
}

 

📌 특징 및 장점

• 요소 제거에 안전 (ConcurrentModificationException 방지)
• 모든 Collection에서 동일한 방식으로 사용 가능
• 메모리 사용량이 효율적 (특히 대용량 데이터 순회 시)

⚠️ 단점

• 코드가 장황함
• remove()는 next() 호출 이후에만 사용 가능
• List.of() 같은 불변 컬렉션에서는 예외 발생

🛠️ 언제 사용할까?

• 순회 중 요소를 제거해야 할 때
• 외부 API에서 받은 컬렉션이 불확실할 때
• 메모리 민감한 환경에서 대량 데이터 처리 시 

---

🔁 for-each

for-each는 Java 5부터 도입된 향상된 for문입니다.

코드가 간결하고 가독성이 좋아, 대부분의 순회 작업에서 사용됩니다

List<String> fruits = List.of("사과", "배", "포도");

for (String fruit : fruits) {
    System.out.println(fruit);
}

 

📌 특징 및 장점

• 가장 직관적인 순회 문법
• 가독성이 뛰어나 협업 코드에 유리
• 배열, List, Set, Map 등 모든 컬렉션에 적용 가능
• 인덱스 신경 쓸 필요 없음

 

⚠️ 단점

• 인덱스 접근 불가
• 요소 제거 시 ConcurrentModificationException 발생

for (String item : list) {
    if (item.equals("B")) {
        list.remove(item);  // ❌ 예외 발생
    }
}

 

🛠️ 언제 사용할까? 

• 단순하게 모든 요소를 처리할 때
• 가독성이 중요한 프로젝트에서
• 요소 삭제가 필요 없는 경우

---

🔸 전통적인 for문

익숙한 for (int i = 0; i <...; i++) 방식으로, 인덱스를 기반으로 세밀한 제어가 필요한 경우 유용합니다.

List<String> songs = Arrays.asList("노래1", "노래2", "노래3");

for (int i = 0; i < songs.size(); i++) {
    System.out.println(i + 1 + "번째: " + songs.get(i));
}

 

📌 특징 및 장점

• 인덱스 활용 가능 (순서 필요할 때 강력)
• 역순 순회, 건너뛰기 등 자유로운 흐름

 

⚠️ 단점

• LinkedList에서는 성능 저하 가능 (get(i)가 O(n))

LinkedList<String> list = new LinkedList<>();
for (int i = 0; i < list.size(); i++) {
    list.get(i);  // 매번 처음부터 탐색!
}

 

 

🛠️ 언제 사용할까?

• 인덱스 기반 접근이 필요한 경우
• ArrayList와 같은 랜덤 접근 컬렉션에서
• 특정 패턴(짝수 인덱스만, 역순 등)이 필요한 경우

---

🔄 forEach 메서드

Java 8부터 추가된 forEach 메서드는 람다 표현식과 함께 사용되며, 간단한 로직을 빠르게 적용할 때 유용합니다.

List<Product> products = getProductList();

products.forEach(product -> {
    if (product.isOnSale()) {
        product.applyDiscount(0.2);
    }
});

 

 

📌 특징 및 장점

• 람다식과 자연스럽게 결합
• Map.forEach((key, value) -> {}) 등에도 활용 가능

 

⚠️ 단점

• break, continue 불가능
• 예외 처리 시 try-catch 필수

 

🛠️ 언제 사용하나?

• 간단한 순회 + 출력/처리
• 람다식 기반의 함수형 스타일로 작성할 때

---

🌊 Stream API 활용

 

Stream은 컬렉션 데이터를 함수형 스타일로 처리할 수 있게 해주는 API입니다.

필터링, 변환, 집계, 병렬 처리 등 복잡한 작업에 적합합니다.

double avg = students.stream()
    .filter(s -> s.getMajor().equals("CS"))
    .mapToDouble(Student::getGpa)
    .average()
    .orElse(0.0);

 

📌 특징 및 장점

• 선언형 처리 → 가독성 높음
• parallelStream()으로 병렬 처리 지원
• filter, map, reduce 등 연산 가능

 

⚠️ 단점

• break/continue 사용 불가
• 학습 곡선 존재
• 과도하게 쓰면 오히려 복잡해짐

 

🛠️ 언제 사용할까?

• 데이터를 필터링, 가공, 집계할 때
• 병렬 처리로 속도 향상이 필요한 경우
• 코드의 선언성과 가독성을 높이고 싶을 때

---

⚠️  자주 만나는 예외: ConcurrentModificationException

ConcurrentModificationException은 컬렉션을 순회 중일 때, 그 컬렉션의 구조를 동시에 수정하면 발생하는 런타임 예외입니다.

 

즉, 다음과 같은 상황에서 발생합니다:

• for-each 또는 Iterator를 통해 순회 중일 때
• remove(), add() 등으로 요소를 직접 변경할 경우

List<String> names = new ArrayList<>(List.of("Tom", "Jane", "Mike"));

for (String name : names) {
    if (name.startsWith("J")) {
        names.remove(name);  // ❌ 예외 발생
    }
}

 

⚠️ 왜 발생할까?

자바의 대부분의 컬렉션 클래스는 내부적으로 “구조 변경 시 fail-fast” 메커니즘을 적용하고 있습니다.

즉, 순회 도중 컬렉션의 크기나 구조가 변경되면 즉시 예외를 던져 버그를 조기에 감지하게 해 줍니다.

빠르게 실패(fail-fast)함으로써, 순회 결과의 불일치나 버그를 방지하는 메커니즘입니다.

 

✅ 안전하게 제거하는 4가지 방법

1️⃣ Iterator.remove() 사용

Iterator를 사용할 경우, next()로 꺼낸 요소에 대해 remove() 메서드를 이용해 안전하게 삭제할 수 있습니다.

List<Integer> numbers = new ArrayList<>(List.of(1, 2, 3, 4, 5, 6));

Iterator<Integer> it = numbers.iterator();
while (it.hasNext()) {
    Integer num = it.next();
    if (num % 2 == 0) {
        it.remove();  // 안전하게 제거
    }
}
System.out.println(numbers);  // [1, 3, 5]

💡 반드시 next()를 호출한 후에 remove()를 써야 합니다.

 

 

2️⃣ removeIf() (Java 8 이상)

컬렉션의 removeIf(Predicate) 메서드를 이용하면 람다식 기반으로 조건을 만족하는 요소만 제거할 수 있습니다.

List<String> words = new ArrayList<>(List.of("apple", "banana", "avocado", "berry"));

words.removeIf(word -> word.startsWith("a"));

System.out.println(words);  // [banana, berry]

간결하고 실무에서 자주 쓰입니다.

 

 

3️⃣ 역방향  for문 사용

앞에서부터 순회하면서 삭제하면 인덱스가 밀려서 오류가 발생할 수 있으므로, 뒤에서부터 거꾸로 순회하면서 제거합니다.

List<String> items = new ArrayList<>(List.of("A", "B", "C", "B", "D"));

for (int i = items.size() - 1; i >= 0; i--) {
    if (items.get(i).equals("B")) {
        items.remove(i);
    }
}

System.out.println(items);  // [A, C, D]

특히 인덱스 기반 삭제가 필요한 경우 효과적입니다.

 

 

4️⃣  Stream.filter()로 새 컬렉션 생성

원본 컬렉션을 변경하지 않고, 조건을 만족하는 요소만 남긴 새로운 리스트를 생성합니다.

List<Integer> numbers = List.of(1, 2, 3, 4, 5, 6);

List<Integer> oddNumbers = numbers.stream()
    .filter(n -> n % 2 != 0)
    .collect(Collectors.toList());

System.out.println(oddNumbers);  // [1, 3, 5]

원본을 유지해야 하거나 불변 컬렉션(List.of 등)을 다룰 때 유용합니다.

 

 

🔍 Tip

• for-each나 stream() 안에서는 절대 remove() 하지 말 것
• 조건에 따라 삭제가 필요하면 → removeIf() / Iterator.remove() / 역방향 for
• 불변 리스트인 경우 → 새로운 컬렉션으로 Stream.filter()로 재생성

---

📊 상황별 추천 가이드

상황	추천 방식	이유
요소 제거	Iterator, removeIf()	안전하게 제거 가능
단순 순회	for-each	직관적, 가독성 우수
인덱스 기반 접근	for문	커스터마이징 용이
데이터 가공	Stream	유연하고 선언적 처리 가능
병렬 처리	parallelStream	CPU 활용 극대화
람다 스타일	forEach()	간결한 표현

---

🙌 마무리

“컬렉션을 꺼내 쓰는 법을 알면, 코드의 품질이 달라진다.”

 

자바의 컬렉션 순회 방식은 단순한 문법 차이가 아니라, 성능과 안전성, 코드 가독성에 직결되는 중요한 선택입니다.

• 단순 순회에는 for-each
• 인덱스가 필요할 땐 전통적인 for
• 요소 삭제가 필요하다면 Iterator 또는 removeIf
• 선언형 스타일이나 병렬 처리에는 Stream

각 방식이 도입된 이유와 쓰임새를 이해하면 불필요한 예외를 방지하고, 더 안정적인 코드를 작성할 수 있습니다.

 

다음 글에서는 제네릭과 와일드카드로 타입 안정성 높이는 방법에 대해 다뤄보겠습니다.

궁금한 점이 있다면 언제든 댓글로 남겨주세요 😊