홈 · CSV · Excel

CSV 업로드가 안 될 때 먼저 확인할 것

CSV 업로드가 실패하면 같은 파일을 계속 다시 올리기보다, 업로드 화면의 오류 문구와 파일의 첫 줄부터 확인하세요. 열 이름, 열 개수, 한글을 읽는 방식 중 어디서 어긋났는지 찾으면 고칠 범위가 좁아집니다.

오류 문구와 첫 줄을 나란히 보세요

예를 들어 쇼핑몰이 상품코드,상품명,가격 세 열을 요구하는데 파일 첫 줄이 상품코드,상품명,상품명이라면 두 번째 상품명은 가격 열이 아닙니다. 값이 모두 들어 있어도 열 이름이 맞지 않아 업로드가 멈출 수 있습니다. 먼저 제출처가 제공한 양식과 첫 줄을 비교하세요.

요구한 열: 상품코드,상품명,가격
파일 첫 줄: 상품코드,상품명,상품명
먼저 고칠 곳: 세 번째 열 이름

이 순서로 원인을 좁혀보세요

  1. 원본 파일을 복사하고, 업로드 화면의 오류 문구와 허용 형식을 적어 둡니다.
  2. CSV 검사기로 파일을 열어 구분자, 첫 줄의 빈 이름·중복 이름, 행마다 다른 열 개수를 봅니다.
  3. 열 이름이 다르면 제출처 양식에 맞춰 고칩니다. 쉼표가 들어간 값 때문에 열이 밀리면 해당 값을 큰따옴표로 감쌉니다.
  4. 한글만 깨진다면 파일을 읽는 문자 방식을 확인하고, 제출처가 요구하는 방식으로 다시 저장합니다.
  5. 다시 올리기 전에 수정한 파일을 별도로 열어 첫 줄과 문제 행을 확인합니다.

검사기는 문제가 의심되는 위치를 보여줍니다. 업로드 사이트의 필수 열이나 허용 인코딩까지 자동으로 알아내지는 못하므로, 그 조건은 제출처 안내에서 확인해야 합니다.

검사 결과가 멀쩡한데도 실패한다면

파일 자체가 정상이어도 업로드 사이트가 .xlsx만 받거나, 파일 크기·행 수·필수 값에 별도 제한을 둘 수 있습니다. 같은 오류가 계속되면 제출처의 예제 파일을 내려받아 열 순서와 저장 형식을 비교하세요. 파일명을 짧은 영문과 숫자로 바꿔 다시 시도해보는 것도 좋지만, 오류 문구가 특정 열을 가리킨다면 그 열부터 고치는 게 우선입니다.

관련 문제를 더 좁혀 보려면 일부 행의 열이 밀릴 때와 한글이 깨질 때를 확인하세요.

실제 예시: ‘필수 열 없음’은 파일이 비었다는 뜻이 아닐 수 있습니다

업로드 템플릿이 product_id,name,price를 요구하는데 CSV가 product id,name,price처럼 공백 하나가 다르거나 첫 헤더 앞에 BOM이 붙어 있으면 시스템은 다른 열 이름으로 볼 수 있습니다. 반대로 ‘열 개수 오류’라면 특정 행의 주소나 메모 안 쉼표가 원인일 수 있습니다.

오류 문구를 보고 구조·헤더·인코딩·값 형식 중 어느 범주인지 먼저 나누면 원인을 훨씬 빨리 찾을 수 있습니다.

첫 방법으로 안 되면 다음 순서로 좁혀보세요

  1. 업로드 템플릿의 헤더와 현재 첫 줄을 문자 단위로 비교합니다.
  2. CSV 검사기로 열 수가 다른 행과 큰따옴표 문제를 확인합니다.
  3. 한글이 깨지면 문자 형식을 확인합니다.
  4. 파일 자체가 정상이라면 업로드처의 최대 행 수·파일 크기·필수값 조건을 확인합니다.

오류를 고치기 위해 정상 데이터를 임의로 삭제하지 마세요. 특히 실패 행 번호를 제공하는 시스템이라면 그 행만 별도 파일로 복사해 재현해 보는 것이 안전합니다.

오류 메시지에 따라 다음 글로 이동하세요

파일에서 원인 찾기CSV 검사기로 첫 줄과 문제 행 확인

파일을 서버에 올리지 않고 브라우저에서 구조를 살펴보세요.

작은 샘플로 파일 문제와 규칙 문제를 나누세요

전체 파일이 실패하면 헤더와 정상 데이터 1~2행만 복사한 샘플을 만들어 업로드해보세요. 샘플도 실패하면 파일 형식, 헤더 이름이나 인코딩 문제일 가능성이 큽니다. 샘플은 성공하고 전체 파일만 실패하면 특정 행의 값, 용량, 행 수 제한을 의심할 수 있습니다.

1단계: 헤더 + 정상 1행
2단계: 헤더 + 정상 10행
3단계: 실패 구간을 절반씩 나눠 추가

오류 메시지가 행 번호를 알려주면 Excel 화면 번호와 CSV 데이터 행 번호가 헤더 때문에 1만큼 다를 수 있습니다. 문제 행 앞뒤도 함께 확인하고 필수값 누락, 날짜 형식, 허용되지 않은 코드, 열 수 차이를 순서대로 점검하세요.

재업로드 전에는 파일명과 확장자, 문자 형식, 구분 문자, 헤더 철자와 열 순서를 다시 확인합니다. 성공 건수와 실패 건수의 합이 제출 데이터 건수와 같은지 비교하고, 거부된 행을 별도 파일로 보관해 임의로 누락되지 않게 하세요.

자주 묻는 질문

오류 문구가 없으면 무엇부터 보나요?

헤더, 열 개수, 인코딩, 빈 필수값을 먼저 확인한 뒤 업로드처의 파일 크기와 행 수 제한을 확인하세요.

Excel에서 정상으로 보여도 CSV가 잘못될 수 있나요?

네. Excel이 일부 문제를 자동으로 해석해 화면상 정상처럼 보일 수 있으므로 원본 텍스트와 CSV 검사 결과를 함께 보는 편이 좋습니다.

CSV 검사에서 이상이 없으면 업로드처 문제인가요?

가능성이 있습니다. 필수값 규칙, 허용 형식, 행 수 제한 등 해당 서비스의 조건을 다음으로 확인하세요.