홈 · CSV · Excel

CSV 첫 번째 헤더 앞에 이상한 글자가 붙을 때

첫 열 이름이 id여야 하는데 id처럼 보이거나 “id 열이 없다”는 오류가 난다면, 파일 맨 앞의 UTF-8 표시(BOM)를 프로그램이 글자로 읽은 경우가 있습니다.

이 문제는 보통 첫 번째 열에서만 나타납니다. Excel에서는 멀쩡해 보이는데 다른 업로드 프로그램이나 스크립트에서만 실패하기도 합니다.

원래 기대한 헤더: id
프로그램이 읽은 값: [BOM]id

상대 프로그램이 BOM 없는 UTF-8을 요구한다면 그 형식으로 다시 저장하면 됩니다. 반대로 어떤 프로그램은 BOM이 있는 파일을 더 잘 읽기도 하니 무조건 지우는 건 아닙니다.

BOM은 파일 맨 앞에 붙는 작은 표시라고 생각하면 됩니다

사람이 메모장으로 볼 때는 잘 안 보이지만, 어떤 프로그램은 이 표시를 첫 번째 열 이름의 일부로 읽습니다.

그래서 id라는 열이 분명 있는데도 “id가 없습니다”라는 오류가 날 수 있습니다.

한글도 같이 깨진다면

첫 헤더뿐 아니라 한글 전체가 이상하다면 BOM보다 파일의 문자 형식을 먼저 확인하는 게 좋습니다.

문자 형식을 바꿔도 안 되면 첫 줄에 빈칸이나 보이지 않는 문자가 더 붙어 있는지 원본과 비교해보세요.

CSV 한글 깨짐 보기 →

실제 업로드에서는 ‘첫 열이 없다’는 오류로 나타나기도 합니다

템플릿이 id,name,email을 요구하는데 첫 헤더 앞에 보이지 않는 BOM 문자가 붙으면 시스템이 id와 다른 이름으로 판단할 수 있습니다. 어떤 프로그램에서는 정상처럼 보이고, 다른 시스템에서는 첫 열만 찾지 못하는 이유가 여기에 있습니다.

텍스트 편집기나 CSV 검사기에서 첫 헤더가 예상과 정확히 같은지 확인하세요. 화면에 id처럼 보이기도 하고, 아무 표시 없이 숨은 문자로 남기도 합니다.

첫 글자를 무조건 지우지는 마세요

  1. 업로드 템플릿의 첫 헤더 이름을 확인합니다.
  2. 현재 CSV의 첫 헤더를 복사해 비교합니다.
  3. UTF-8 저장 방식과 BOM 유무를 확인한 뒤 정상 인코딩으로 다시 저장합니다.
  4. 첫 헤더뿐 아니라 나머지 한글도 정상인지 다시 엽니다.

‘이상해 보이니까 첫 글자 하나 삭제’ 방식은 실제 헤더 글자를 지울 수 있습니다. 한글도 함께 깨진다면 BOM 하나의 문제가 아니라 문자 인코딩을 잘못 읽은 것일 수 있으니 먼저 인코딩부터 맞추세요.

헤더와 인코딩 문제를 더 확인하려면

바로 쓰는 도구CSV 검사기

첫 번째 헤더와 파일 형식을 먼저 확인해보세요.

저장 방식별로 다시 확인하세요

같은 CSV라도 저장한 프로그램에 따라 BOM 유무가 달라질 수 있습니다. Excel에서 ‘CSV UTF-8’로 저장한 파일과 텍스트 편집기에서 ‘UTF-8(BOM 없음)’으로 저장한 파일은 화면상 내용이 같아도 첫 바이트가 다를 수 있습니다. 업로드처가 어느 형식을 요구하는지 먼저 확인하고, 요구사항이 없으면 작은 샘플 파일로 한 번 시험하세요.

파일을 수정할 때는 첫 글자를 눈으로 찾아 삭제하지 마세요. 처럼 보이는 글자는 BOM 바이트가 잘못 해석된 결과일 수 있고, 편집 프로그램에 따라 아예 보이지 않을 수도 있습니다. 인코딩을 선택해 다시 저장하거나 내보내기 기능을 이용하는 편이 안전합니다.

확인 순서: 첫 헤더 이름 비교 → 파일 인코딩 확인 → 다른 이름으로 저장 → 1~2행 샘플 업로드

수정 후에는 첫 헤더뿐 아니라 한글, 쉼표가 포함된 값, 앞자리 0이 있는 코드도 함께 확인합니다. BOM 문제를 해결하는 과정에서 인코딩이나 구분 문자가 달라지면 새로운 오류가 생길 수 있습니다. 원본과 수정본의 행 수와 열 수까지 같아야 작업이 끝난 것입니다.

개발 환경에서는 헤더를 그대로 출력해보세요

스크립트나 데이터베이스 업로드에서 오류가 난다면 첫 번째 열 이름을 대괄호나 따옴표와 함께 출력해 실제 문자열을 확인합니다. 화면에는 id로 보여도 길이가 예상보다 길거나 앞에 보이지 않는 문자가 있을 수 있습니다. 열 이름을 임의로 잘라내기보다 CSV 읽기 단계에서 UTF-8 BOM을 지원하는 옵션을 사용하거나, 권한 있는 원본을 BOM 없는 UTF-8로 다시 저장하세요.

팀에서 반복해서 같은 문제가 생긴다면 전달 규칙에 파일 인코딩과 BOM 유무를 명시합니다. 예를 들어 “UTF-8, BOM 없음, 쉼표 구분, 첫 행 헤더”처럼 기록하면 만든 사람과 받는 사람이 같은 기준으로 확인할 수 있습니다.

자주 묻는 질문

BOM이 있으면 CSV가 항상 잘못된 파일인가요?

아닙니다. UTF-8 BOM을 정상적으로 처리하는 프로그램도 많습니다. 문제는 업로드 시스템이 첫 헤더의 BOM을 문자처럼 해석할 때 생깁니다.

첫 헤더만 이상하고 나머지는 정상일 수 있나요?

네. BOM은 파일 맨 앞에 붙기 때문에 첫 번째 헤더에서만 문제가 보일 수 있습니다.

한글도 깨지면 BOM만 지우면 되나요?

그렇지 않을 수 있습니다. 한글까지 깨지면 전체 문자 인코딩을 잘못 읽은 것인지 먼저 확인하세요.