CSV 업로드 실패, 열 순서·이름부터 확인하세요
회계 프로그램이나 쇼핑몰 관리자 페이지에 CSV 파일을 올렸는데 값이 엉뚱한 열에 들어가거나 업로드 자체가 거부된 적이 있다면, 파일이 손상된 게 아닙니다.
CSV는 값과 구분자만 나열한 텍스트라 열의 의미를 담는 자리가 따로 없어서, 열 순서나 헤더 이름이 그 프로그램이 기대하는 것과 조금만 달라도 이런 일이 생깁니다.
요약 ① CSV는 값과 구분자만 있는 텍스트라, 열의 의미는 첫 줄(헤더)의 문자열이나 열의 위치로만 전달됩니다. ② 값을 받는 프로그램은 이 헤더를 "순서"로 맞추거나 "이름"으로 맞추는데, 둘 중 어느 쪽이든 하나만 어긋나도 값이 밀리거나 거부됩니다. ③ 헤더 앞뒤에 붙은 보이지 않는 공백 하나도 "다른 이름"으로 취급되어, 원인을 찾기 어려운 실패로 이어집니다.
CSV 업로드가 어긋나는 이유 — 왜 이런 일이 생기나
예를 들어 은행에서 받은 거래 내역 CSV는 거래일자, 거래처명, 금액, 사업자등록번호 순서로 되어 있는데, 회계 프로그램이 요구하는 양식은 거래일자, 거래처명, 사업자등록번호, 금액 순서라고 해봅니다.
이 파일을 그대로 올리면 회계 프로그램은 세 번째 열을 '사업자등록번호'라고 믿고 읽기 때문에, 실제로는 금액 값이 사업자등록번호 자리에 들어갑니다. 파일도 프로그램도 잘못이 없고, 셋째 열의 자리만 다른 것뿐입니다.
헤더 이름으로 매칭하는 프로그램이라면 반대로 동작합니다. 첫 줄 문자열이 프로그램이 아는 이름과 글자 하나까지 같아야 그 열을 찾으므로, 순서는 달라도 되지만 이름이 다르면(예: '사업자번호' vs '사업자등록번호') 그 열 자체를 못 찾아 오류를 냅니다.
열 순서·이름을 맞추는 방법 — 도구 없이 확인하기
도구 없이도 세 단계로 확인할 수 있습니다. 순서가 맞을수록 나중에 손댈 부분이 줄어듭니다.
1. 대상 프로그램이 요구하는 양식을 먼저 확인합니다
가장 먼저 확인할 것은 대상 프로그램이 요구하는 정확한 헤더 이름과 순서입니다. 대부분 관리자 페이지의 '양식 다운로드'나 안내 문서에 이 정보가 나와 있습니다.
2. 받은 파일의 첫 줄을 글자 그대로 대조합니다
받은 CSV를 메모장 같은 텍스트 편집기로 열어 첫 줄만 눈으로 대조합니다. 철자·공백·대소문자까지 요구 양식과 정확히 같은지 확인합니다.
3. 엑셀에서 순서·이름·공백을 정리합니다
순서가 다르면 엑셀에서 열 머리글을 선택해 잘라내기한 뒤 원하는 위치에 삽입하고, 이름이 다르면 헤더 셀을 더블클릭해 고쳐 씁니다. 공백은 찾기 및 바꾸기로 지울 수 있습니다.
문제는 이 작업을 파일마다, 열마다 반복해야 한다는 점입니다. 열이 여러 개거나 비슷한 파일을 자주 받는다면 수작업은 금방 번거로워집니다.
저희 도구로 확인하기. 체크박스로 필요한 열만 남기고, ▲▼ 버튼으로 순서를 바꾸고, 이름 칸에 새 헤더를 바로 입력할 수 있습니다.
무료 · 가입 불필요 · 업로드한 CSV는 브라우저 밖으로 전송되지 않습니다
자주 막히는 지점
| 증상 | 원인 |
|---|---|
| 값이 한 칸씩 밀려 엉뚱한 열에 들어감 | 받는 프로그램이 "순서"로 열을 판단하는데 파일의 열 순서가 다름 |
| 업로드 자체가 거부됨(형식 오류) | 받는 프로그램이 "헤더 이름"으로 판단하는데 철자가 다름 |
| 특정 열만 계속 인식되지 않음 | 헤더 앞뒤에 눈에 안 보이는 공백이 남아 문자열이 정확히 일치하지 않음 |
| 열은 맞는데 값이 한 줄에 몰려 들어감 | 구분자가 쉼표가 아니라 세미콜론·탭인데 쉼표로만 나눠 읽음 |
표의 네 가지 원인은 모두 열의 위치·이름·구분자라는 세 가지 신호 중 하나가 어긋난 경우입니다. 어느 쪽이든 파일 내용을 고칠 필요 없이 열을 다시 배열하거나 이름과 공백만 정리하면 해결됩니다.
정리
- CSV는 열의 의미를 순서 아니면 헤더 이름으로만 전달하며, 받는 프로그램에 따라 둘 중 하나가 정확히 맞아야 합니다.
- 업로드 실패나 값 밀림은 대부분 파일 손상이 아니라 이 둘 중 하나가 어긋난 기계적인 문제입니다.
- 대상 프로그램이 요구하는 헤더 이름·순서를 먼저 확인하고 맞추면 대부분 해결됩니다.
- 눈에 보이지 않는 공백도 실패 원인이 될 수 있어 이름을 맞출 때 함께 정리해야 합니다.
무료 · 가입 불필요 · 업로드한 CSV는 브라우저 밖으로 전송되지 않습니다
자주 묻는 질문
CSV에 헤더(첫 줄)가 아예 없으면 어떻게 확인하나요?
헤더가 없는 파일은 이름으로 비교할 문자열 자체가 없으므로, 받는 프로그램은 오직 열의 위치로만 값을 판단합니다. 이 경우 프로그램이 정한 n번째 열의 의미를 문서로 확인하고, 그 순서에 맞춰 열을 배치해야 합니다.
구분자가 쉼표가 아니라 세미콜론이면 CSV 파일이 아닌가요?
확장자가 .csv라도 실제 구분자는 쉼표가 아닐 수 있습니다. 지역별 소프트웨어 설정에 따라 세미콜론이나 탭으로 구분된 파일을 내보내는 경우가 흔하며, 이 역시 CSV로 취급됩니다. 열기 전 텍스트 편집기로 첫 줄을 확인해 실제 구분자를 파악하는 편이 안전합니다.
엑셀에서 저장하면 헤더의 앞뒤 공백이 자동으로 지워지지 않나요?
아니요. 엑셀은 셀에 입력된 공백을 그대로 저장하며, 저장 시 자동으로 정리하지 않습니다. 눈으로만 봐서는 공백 유무를 구분하기 어려우므로, 헤더가 정확히 일치하는지 확인하려면 별도로 정리하는 과정이 필요합니다.