핵심 답변
“중복”은 서로 다른 두 가지를 뜻할 수 있습니다.
같은 SKU가 CSV 파일에 두 번 나타나거나, CSV 행이 WooCommerce 스토어의 기존 상품과 일치할 수 있습니다. 첫 번째는 파일만으로 확인할 수 있지만, 두 번째는 스토어 내보내기 파일과 가져오기 로그가 필요합니다. “기존 상품 업데이트”를 선택하면 WooCommerce는 ID 또는 SKU로 기존 상품을 찾습니다.
가져오기 로그를 저장하고 스토어를 백업한 다음, 수정하지 않은 상품 내보내기 파일을 보관하세요. 오류를 없애기 위해 운영 중인 SKU를 함부로 바꾸지 마세요. 주문, 재고 연동, 다른 시스템에서 사용할 수 있습니다.
행을 처리하기 전에 파일이 거부된다면 먼저 WooCommerce CSV 오류 체크리스트(영어)를 확인하세요.
네 가지 경우
실패한 행의 상황에 맞춰 해결하세요.
스토어에 같은 SKU가 이미 있음
CSV 행의 SKU가 일치해도 새 상품 만들기 가져오기가 자동으로 업데이트로 바뀌지는 않습니다.
다음 단계: 기존 상품을 수정하려면 현재 상품 행을 내보내고 “기존 상품 업데이트” 옵션을 확인하세요. 실제로 새로운 상품이라면 고유한 SKU를 지정하세요.
파일의 두 행에 같은 SKU가 있음
상품이나 변형에는 명확하고 고유한 식별자가 필요합니다. 파일 안의 중복 SKU는 사람이 판단해야 합니다.
다음 단계: 두 행이 같은 상품, 서로 다른 상품, 다른 변형 중 무엇을 뜻하는지 확인하세요. 의도한 식별자를 유지하고 모든 중복 값에 무작정 번호를 붙이지 마세요.
업데이트 모드에서 일치하지 않는 행을 건너뜀
WooCommerce는 ID 또는 SKU로 기존 상품을 찾습니다. 일반적으로 일치하지 않는 상품 행은 업데이트 중 건너뜁니다.
다음 단계: 해당 스토어의 최신 내보내기 파일과 비교하세요. 일치해야 하는 ID 또는 SKU를 수정하고, 진짜 새 상품은 별도의 새 상품 만들기 가져오기로 처리하세요.
변형을 건너뛰거나 잘못된 상위 상품에 연결
변형에는 자체 식별자가 필요하고 Parent 열은 의도한 가변 상품을 가리켜야 합니다.
다음 단계: 상위 상품 SKU 또는 id:123, 각 변형의 SKU와 속성 값을 확인하세요. 업데이트 중 새 변형 행의 처리 방식은 WooCommerce 버전과 행의 조건에 따라 다릅니다.
도구의 한계
로컬 검사로는 스토어 상태를 볼 수 없습니다.
- CSV 파일 안에서 중복된 SKU
- 누락된 식별자와 일반적인 행 구조 문제
- 이 스토어에 이미 있는 ID와 SKU
- 가져오기 모드, 열 매핑, 건너뛴 행의 로그
- 설치된 버전에서 변형이 생성되는 조건
무료 검사는 브라우저에서만 실행됩니다. WooCommerce에 연결하지 않으며, 기존 SKU가 어떤 상품을 업데이트해야 하는지도 결정하지 않습니다.
안전한 재검증
소량으로 모드와 식별자를 확인하세요.
- 01보존
스토어를 백업하고 로그와 최신 상품 내보내기 파일을 저장합니다.
- 02분류
파일 내부 중복과 스토어에 이미 있는 SKU를 구분합니다.
- 03선택
새 상품 만들기 또는 업데이트를 결정하고 열 매핑을 확인합니다.
- 04소량 테스트
가능하면 테스트 환경에서 대표적인 한두 행을 가져옵니다.
- 05결과 확인
상품, 변형, 가격, 재고, 로그를 확인한 뒤 범위를 확대합니다.
공식 자료(영어)