DEV WIKI
인프라 · 체크리스트

카페24 이미지·파일 업로드 오류 확인표

카페24 상품 이미지, 디자인 파일업로더, 게시판 첨부 파일이 올라가지 않을 때 화면별 용량·형식·개수 제한을 구분하는 확인표입니다.

적용 범위
본문에 적힌 운영 시점과 적용 환경이 일치하는 경우
출처
Cafe24
출처 확인일
2026-08-29
최종 검토
2026-08-29
수정일
2026-08-29
적용 시점
장애 대응, 변경·이전
오류·수정 제보 (새 창에서 열림)

시작 전 확인

  • 오류가 발생한 카페24 관리자 메뉴와 알림창의 원문을 기록합니다.
  • 원본 파일 대신 확장자·크기·가로세로 크기·업로드 개수만 기록할 수 있어야 합니다.

확인 항목

오류가 보인 관리자 메뉴, 오류 문구, 파일 확장자·크기·개수와 발생 시각을 기록합니다.

상품 이미지, 디자인 파일업로더, 게시판 첨부, FTP·PHP 폼 중 어느 업로드 기능인지 구분합니다.

상품 이미지라면 10MB 이하, 세로 25600px 미만, gif·png·jpg·jpeg, 상품당 최대 200장 조건을 확인합니다.

디자인 파일업로더라면 파일당 10MB, 허용 확장자와 폴더당 1000개 제한을 확인합니다.

게시판 첨부라면 첨부 기능 사용 여부, 금지 확장자, 게시 글당 최대 5개, 최대 10MB 설정을 확인합니다.

FTP 로그인 후 업로드만 실패하면 웹하드 용량을 확인하고, PHP 폼이면 PHP 제한과 임시 경로를 별도로 확인합니다.

수정 후 같은 계정·화면·비민감 테스트 파일로 다시 업로드하고 저장 결과를 확인합니다.

완료 판정

  • 적용한 카페24 업로드 기능과 해당 기능의 제한값을 구분해 기록합니다.
  • 같은 화면과 비민감 테스트 파일의 반복 확인에서 업로드·저장 결과가 확인됩니다.

주의사항

변경 전 확인

  • 관리자 업로더의 제한을 PHP 설정 문제로 단정해 서버 제한이나 디렉터리 권한을 임의로 바꾸지 않습니다.
  • 고객 이미지·문서·개인정보가 포함된 원본 파일을 외부 점검 자료에 첨부하지 않습니다.

담당자에게 전달할 내용

  • 카페24 관리자 메뉴, 오류 원문, 파일 조건, 제한값과 재검사 결과를 담당자에게 전달합니다.

적용 범위와 근거

카페24에서 이미지나 첨부 파일이 올라가지 않으면 어느 업로드 기능에서 실패했는지 먼저 구분합니다. 상품 이미지, 디자인 파일업로더, 게시판 첨부, FTP와 PHP 폼은 서로 다른 제한을 사용합니다.

먼저 구분할 화면

업로드 위치먼저 기록할 값카페24 공식 제한
상품 이미지알림창의 실패 파일명·원인, 크기, 세로 픽셀, 확장자, 현재 이미지 수10MB 이하, 세로 25600px 미만, gif·png·jpg·jpeg, 상품당 최대 200장
디자인 파일업로더file creation is possible up to 1000 표시 여부, 폴더 파일 수, 크기, 확장자파일당 10MB, 허용 확장자만 가능, 폴더당 1000개 이하
게시판 첨부첨부 기능 사용 여부, 확장자, 크기, 개수금지 확장자 적용, 게시 글당 최대 5개, 최대 10MB 설정
FTP로그인 성공 여부, 업로드 실패 여부, 웹하드 사용량로그인은 되지만 업로드만 실패하면 사용량 모니터링의 HDD 용량 확인
PHP 폼Network 응답, PHP 업로드 오류 코드, 파일·POST 제한파일 업로드가 완료되지 않아요에서 PHP 제한을 별도로 확인

확인 순서

  1. 오류가 발생한 관리자 메뉴와 알림창 문구를 원문 그대로 기록합니다.
  2. 원본 파일 대신 확장자·파일 크기·이미지 가로세로 크기·선택한 파일 개수를 기록합니다.
  3. 위 표에서 같은 업로드 위치의 제한만 비교합니다. 상품 이미지 제한을 게시판이나 FTP에 적용하지 않습니다.
  4. 이미지 업로드 진행 중 오류가 발생했습니다.가 보이면 알림창 아래의 업로드 불가 파일명과 원인을 먼저 확인합니다.
  5. file creation is possible up to 1000이 보이면 현재 폴더의 파일 수를 확인하고 새 폴더나 하위 폴더로 나눠 검사합니다.
  6. 게시판이면 파일 첨부 기능이 켜져 있는지 확인한 뒤 확장자·크기·개수를 각각 비교합니다.
  7. 같은 화면에서 비민감 테스트 파일 하나로 다시 업로드하고 관리자 목록이나 저장 위치에서 결과를 확인합니다.

원인 비교표

관찰 결과우선 확인할 구간다음 판단
상품 이미지 알림에 용량·세로 크기·형식·개수 원인이 표시됨상품 이미지 조건표시된 조건 하나만 맞춘 테스트 이미지로 다시 확인합니다.
file creation is possible up to 1000디자인 파일업로더의 폴더 파일 수새 폴더 또는 하위 폴더로 나눠 다시 확인합니다.
게시판에서 첨부 버튼이 없거나 특정 파일만 거부됨게시판 파일 첨부 사용 여부·금지 확장자관리자 설정과 파일 조건을 비교합니다.
FTP 로그인은 되지만 업로드만 실패함웹하드 사용량사용량 모니터링에서 HDD 용량을 확인합니다.
PHP 폼에서 UPLOAD_ERR_*가 확인됨PHP 파일·POST·임시 경로 제한범용 파일 업로드 Guide의 해당 Problem으로 이동합니다.

기록 양식

카페24 관리자 메뉴:오류 알림 원문:파일 확장자·크기·가로세로·개수:비교한 공식 제한:변경한 조건 한 가지:같은 화면에서 재검사한 결과:

공식 제한과 실제 알림이 다르면 카페24 관리자 메뉴, 오류 원문과 파일 조건을 함께 기록해 담당자에게 전달합니다. 원인을 확인하기 전에 PHP 제한이나 서버 디렉터리 권한을 넓히지 않습니다.

관련 플랫폼

참고 자료

이미지 업로드 시 오류가 발생해요. – 카페24 Help Center (새 창에서 열림)

Cafe24 · 공식 자료 · 확인 범위: 상품 이미지 업로드 오류 알림은 업로드가 불가능한 파일명과 원인을 표시합니다., 상품 이미지는 10MB 이하, 세로 25600px 미만, gif·png·jpg·jpeg 형식, 상품당 최대 200장 조건을 사용합니다. · 확인일: 2026-08-29

파일업로더 관련 자주 묻는 질문 – 카페24 Help Center (새 창에서 열림)

Cafe24 · 공식 자료 · 확인 범위: 디자인 파일업로더는 파일당 10MB 제한과 별도의 허용 확장자 목록을 사용합니다., 파일업로더는 한 폴더에 1000개를 초과해 등록할 수 없으며 별도 폴더나 하위 폴더로 나눌 수 있습니다. · 확인일: 2026-08-29

게시판 관리 – 카페24 Help Center (새 창에서 열림)

Cafe24 · 공식 자료 · 확인 범위: 게시판은 파일 첨부 사용 여부, 금지 확장자, 게시 글당 최대 5개 제한을 별도로 설정합니다., 게시판 첨부 파일 용량은 최대 10MB까지 설정할 수 있습니다. · 확인일: 2026-08-29

FTP 접속 또는 업로드가 되지 않아요 – 카페24 Help Center (새 창에서 열림)

Cafe24 · 공식 자료 · 확인 범위: FTP 로그인은 되지만 업로드만 실패하면 사용량 모니터링에서 HDD 용량을 확인합니다. · 확인일: 2026-08-29