CSV 열 이름이 중복되어 업로드가 안 될 때
CSV 첫 줄에 같은 열 이름이 두 번 있으면 업로드 프로그램이 어느 열을 뜻하는지 구분하지 못할 수 있습니다. 첫 줄의 이름을 하나씩 확인하고, 서로 다른 데이터를 담은 열에는 서로 다른 이름을 붙이세요.
같은 이름이 정말 두 번 있는지 확인하세요
예를 들어 주문 파일의 첫 줄이 아래처럼 되어 있으면 상품명이 두 번 나옵니다. 두 번째 열이 옵션명이라면 그 이름을 옵션명으로 고쳐야 합니다. 값이 같은 열이라도 무작정 삭제하지 말고 제출처 양식에서 어떤 열을 요구하는지 먼저 확인하세요.
수정 전: 주문번호,상품명,상품명,수량
수정 후: 주문번호,상품명,옵션명,수량일부 프로그램은 중복 이름 뒤에 숫자를 자동으로 붙이지만, 다른 프로그램은 오류를 냅니다. 따라서 업로드가 성공하더라도 열이 올바르게 연결됐는지 미리보기를 확인해야 합니다.
원본을 남기고 첫 줄만 고치세요
- 원본 CSV를 복사해 보관합니다.
- CSV 검사기에 복사본을 넣고
중복 헤더또는빈 헤더안내가 나오는지 봅니다. - 제출처의 예제 파일과 열 이름·순서를 비교합니다.
- 이름이 겹치는 열을 실제 뜻에 맞게 바꾸고, 쉼표 수나 다른 데이터 행은 건드리지 않습니다.
- 수정본을 다시 검사한 뒤 업로드 화면에서 열 연결 미리보기를 확인합니다.
겉으로는 이름이 달라 보여도 앞뒤 공백 때문에 예상과 다르게 읽힐 수 있습니다. 첫 줄에서 불필요한 공백도 살펴보세요.
중복 안내가 없는데도 업로드가 안 된다면
열 이름 대신 일부 행의 열 개수가 다른지 확인하세요. 특히 주소나 메모에 쉼표가 들어 있는데 큰따옴표가 빠지면 그 행만 오른쪽으로 밀립니다. 한글이 깨져 열 이름 자체가 달라진 경우에는 문자 방식 문제를 먼저 해결해야 합니다. CSV 업로드 점검 순서에서 다른 원인도 확인할 수 있습니다.
실제 예시: 같은 열 이름이 두 번이면 어느 값을 써야 할지 모호합니다
첫 줄이 id,name,email,email이라면 업로드 시스템은 두 번째와 세 번째가 아닌 두 개의 email 열 중 어느 것을 기준으로 할지 결정하기 어렵습니다. 어떤 시스템은 첫 번째만 사용하고, 어떤 시스템은 오류로 중단합니다.
중복 열을 발견했다고 바로 하나를 삭제하지 말고 실제 값이 같은 의미인지 먼저 확인하세요. 예를 들어 하나는 주문자 이메일, 다른 하나는 수령인 이메일이라면 이름을 buyer_email, receiver_email처럼 구분해야 합니다.
헤더를 고친 뒤 데이터 위치도 확인하세요
- 첫 줄에서 중복된 이름을 찾습니다.
- 각 열의 실제 데이터 3~5행을 비교해 의미를 확인합니다.
- 업로드 템플릿이 요구하는 정확한 헤더명으로 수정합니다.
- 열을 삭제했다면 그 열의 데이터까지 함께 사라져도 되는지 확인합니다.
겉으로 같은 헤더가 없는데도 오류가 계속되면 첫 헤더의 BOM, 앞뒤 공백, 대소문자 또는 템플릿의 정확한 이름 조건을 다음으로 확인하세요.
헤더 문제가 계속되면
검사 결과를 본 뒤 제출처 양식에 맞게 직접 수정하세요.
열 이름을 바꿀 때 데이터 의미도 확인하세요
name,name처럼 완전히 같은 헤더가 두 개라면 각각 무엇을 뜻하는지 데이터 값을 보고 구분합니다. 첫 번째가 주문자 이름이고 두 번째가 수령인 이름이라면 buyer_name과 receiver_name처럼 역할이 드러나는 이름으로 바꿔야 합니다. 단순히 name2로 바꾸면 다음 작업에서 다시 혼동하기 쉽습니다.
눈에는 달라 보여도 앞뒤 공백이나 대소문자를 무시하는 업로드 시스템에서는 같은 이름으로 판단할 수 있습니다. email, Email, email 을 각각 다른 열로 인정할 것이라고 가정하지 말고, 템플릿이 요구하는 철자와 규칙을 따르세요.
변경 전: id,name,name
변경 후: id,buyer_name,receiver_name헤더를 바꾼 뒤에는 열 순서와 데이터가 함께 이동하지 않았는지 확인합니다. 첫 데이터 행을 기준으로 각 열 값의 의미를 읽고, 필수 헤더 누락과 예상하지 않은 추가 헤더도 함께 검사하세요. 수정본을 작은 샘플로 먼저 업로드하면 전체 파일에서 같은 오류를 반복하는 일을 줄일 수 있습니다.
수정본의 헤더만 따로 검산하세요
최종 파일의 첫 줄을 다시 읽어 중복이 없는지, 빈 헤더가 없는지, 필수 헤더가 모두 있는지 확인합니다. 열 이름을 바꾼 뒤 데이터 열이 함께 이동하지 않았는지도 첫 데이터 행으로 대조하세요. 업로드 템플릿이 순서를 요구한다면 이름뿐 아니라 열 순서도 맞춰야 합니다.
자동으로 name.1이나 name_2를 붙이는 프로그램도 있지만 그 이름이 업무 의미를 설명하지는 않습니다. 임시 이름을 그대로 제출하지 말고 원본 제공자와 열의 역할을 확인해 지속적으로 사용할 이름으로 정리하세요.
자주 묻는 질문
대소문자만 다른 헤더도 중복인가요?
시스템에 따라 같은 이름으로 취급할 수 있습니다. 업로드 템플릿이 요구하는 정확한 철자를 사용하는 것이 안전합니다.
중복 열 하나를 그냥 삭제해도 되나요?
두 열의 데이터 의미가 같은지 확인한 뒤 결정해야 합니다. 서로 다른 의미라면 이름을 구분해야 합니다.
헤더가 중복이 아닌데 같은 오류가 나면요?
BOM, 앞뒤 공백, 숨은 문자, 필수 헤더명 불일치를 확인하세요.