WooCommerce 상품 CSV 가져오기 오류: 원인과 해결 방법

WooCommerce가 CSV 가져오기를 검증하는 방식

WooCommerce에 기본으로 들어 있는 상품 가져오기 도구는 CSV 파일을 읽고 열 이름으로 열을 연결합니다. 그리고 각 행을 WooCommerce 상품 데이터 모델에 맞춰 검증합니다. 검증에 실패하면 해당 행을 건너뛰고 오류를 기록합니다. 가져오기가 끝나면 가져온 행 수, 건너뛴 행 수와 그 이유를 요약해서 보여 줍니다.

WordPress를 한국어로 쓰고 있다면 내보내기 파일의 열 이름이 한국어로 나옵니다(예: Type 대신 "유형"). 가져오기 도구는 두 가지 이름을 모두 인식합니다. 이 가이드에서는 영어 열 이름을 사용합니다.

검증 규칙을 알면 가져오기 실패의 대부분을 미리 막을 수 있습니다.

오류: 상품 유형이 잘못되었거나 없음

원인: Type 열에 인식할 수 없는 값이 있거나 열 자체가 없습니다.

허용 값:

| Type | 설명 | |---|---| | simple | 변형이 없는 단순 상품 | | variable | 변형이 있는 상품(상위 행) | | variation | 가변 상품의 특정 변형(하위 행) | | grouped | 관련 상품의 묶음 | | external | 외부 사이트로 연결되는 상품 |

해결 방법:

• Type 열이 없으면 추가하세요
• 직접 만든 값이나 철자가 틀린 값을 위의 값 중 하나로 바꾸세요
• Variable(대문자 V)과 variable은 다릅니다. 소문자를 쓰세요

오류: SKU가 없거나 중복됨

원인: 단순 상품이나 가변 상품 행의 SKU가 비어 있거나, 같은 SKU가 서로 다른 두 행에 있습니다.

WooCommerce는 가져오는 행을 기존 상품과 맞춰 보는 고유 식별자로 SKU를 씁니다. SKU가 비어 있으면 기존 상품을 업데이트하지 않고 가져올 때마다 새 상품을 만듭니다.

해결 방법:

• 모든 상품 행(단순 상품과 가변 상품의 상위 행)에 고유한 SKU를 넣으세요
• 변형 행은 상위 상품의 SKU를 물려받거나 자체 SKU를 가질 수 있지만, 다른 상품의 SKU와 겹치면 안 됩니다
• Excel의 COUNTIF로 중복을 찾으세요: =COUNTIF($A:$A, A2) 결과가 1보다 크면 중복입니다

오류: 정가가 잘못됨

원인: Regular price에 통화 기호(€, $)가 있거나, 소수점으로 쉼표를 썼거나(19,99), 단순 상품이나 가변 상품에서 비어 있습니다.

해결 방법:

• 통화 기호를 없애세요: 찾기 및 바꾸기로 $, €, £를 지우세요
• 소수점 쉼표를 마침표로 바꾸세요: 19,99 → 19.99
• 모든 단순 상품과 가변 상품에 가격이 있는지 확인하세요. 변형 행은 상위 상품의 가격을 물려받을 수 있습니다

오류: 참/거짓 필드가 잘못됨

원인: WooCommerce의 참/거짓 열(In stock?, Backorders allowed?, Sold individually?, Is featured?)은 1(참) 또는 0(거짓)만 받습니다. yes, TRUE, Y 같은 값은 검증 오류를 일으킵니다.

해결 방법: 모든 참/거짓 값을 바꾸세요.

| 바꿀 값 | 바뀔 값 | |---|---| | yes, Yes, TRUE, true | 1 | | no, No, FALSE, false | 0 |

"전체 셀 내용 일치"를 켠 상태로 찾기 및 바꾸기를 사용하세요.

오류: 변형의 상위 상품을 찾을 수 없음

원인: Type: variation인 행이 가져오기 파일에도 데이터베이스에도 없는 상위 상품을 참조합니다.

WooCommerce 변형 행에는 상위 상품이 필요합니다. 상위 상품과는 Parent 열(데이터베이스의 상위 상품 ID를 넣어야 함)로 연결하거나, 같은 가져오기 파일에 상위 상품을 넣어 연결합니다.

해결 방법:

• 상위 상품 행을 같은 CSV 파일에 넣으세요
• 변형 행의 Parent 열에 상위 상품의 WooCommerce 상품 ID(WordPress 관리자에 표시되는 번호)를 넣으세요
• 상위 행이 Type: simple이 아니라 Type: variable인지 확인하세요

오류: 속성 열을 인식하지 못함

원인: 속성 열 이름이 WooCommerce의 이름 규칙을 정확히 따르지 않습니다.

WooCommerce 속성 열 형식:

• Attribute 1 name: 첫 번째 속성의 이름(예: Color)
• Attribute 1 value(s): 이 행의 값(예: Blue, 여러 개라면 Blue | Red)
• Attribute 1 visible: 상품 페이지에 표시하면 1, 숨기면 0
• Attribute 1 global: 전역 속성을 쓰면 1, 로컬 속성이면 0

해결 방법:

• 공백까지 포함한 정확한 형식을 쓰세요: attribute_1_name이나 Attribute1Name이 아니라 Attribute 1 name
• 속성은 1부터 차례로 번호를 매기세요
• 번호를 건너뛰지 마세요(Attribute 2를 쓰지 않았다면 Attribute 3도 쓰지 마세요)

오류: 이미지 URL에 접근할 수 없음

원인: Images 열의 이미지 URL이 공개된 HTTPS URL이 아니거나, 로그인이 필요하거나, HTTPS가 아닌 프로토콜을 씁니다.

WooCommerce는 가져오는 동안 이미지를 내려받아 미디어 라이브러리에 저장합니다.

해결 방법:

• 각 이미지 URL을 브라우저에서 열어 로그인 없이 이미지가 바로 표시되는지 확인하세요
• HTTP가 아니라 HTTPS URL을 쓰세요
• Google 드라이브나 Dropbox의 이미지는 공유 링크가 아니라 직접 다운로드 링크를 쓰세요
• 이미지가 localhost나 스테이징 서버에 있다면 먼저 공개된 위치로 옮기세요

WooCommerce 가져오기 오류 보고서 읽는 법

가져오기가 끝나면 WooCommerce가 다음과 같은 요약을 보여 줍니다.

• "제품 X개 가져옴": 생성 또는 업데이트에 성공한 수
• "제품 X개 실패": "가져오기 로그 보기"를 클릭하면 어떤 행이 왜 실패했는지 알 수 있습니다

가져오기 로그에는 행 번호와 구체적인 오류가 표시됩니다. 행 번호로 CSV에서 해당 행을 찾으세요(머리글이 1행이므로 데이터는 2행부터 시작합니다).

StriveFormats로 자동 수정

WooCommerce CSV를 StriveFormats에 업로드하세요. 검사기가 상품 유형, SKU, 가격, 참/거짓 값, 속성 열, 상위 상품과 변형의 관계를 확인하고 안전한 문제는 자동으로 수정합니다.

WooCommerce CSV 수정기 열기 | WooCommerce 템플릿 보기