워드프레스 이미지 업로드 오류 점검표
워드프레스 미디어 라이브러리에서 이미지 업로드 오류가 발생할 때 요청, PHP 제한, 업로드 디렉터리와 이미지 처리 단계를 구분하는 점검표입니다.
- 적용 범위
- 본문에 적힌 운영 시점과 적용 환경이 일치하는 경우
- 출처 확인일
- 2026-08-29
- 최종 검토
- 2026-08-29
- 수정일
- 2026-08-29
- 정정 이력
- 2026-07-29 이후 기록 없음
- 적용 시점
- 장애 대응, 변경·이전
시작 전 확인
- WordPress 관리자와 도구 > 사이트 건강 > 정보 화면을 볼 수 있어야 합니다.
- 개인정보가 없는 테스트 이미지의 형식과 크기를 기록합니다.
- PHP 또는 디렉터리 설정을 바꾸기 전 현재 값을 보관합니다.
확인 항목
미디어 라이브러리에 표시된 오류 문구, 발생 시각, 파일 형식·크기와 브라우저 Network의 업로드 요청 상태를 기록합니다.
도구 > 사이트 건강 > 정보 > 미디어 처리에서 파일 업로드 허용 여부, POST 최대 크기, 업로드 최대 크기와 유효 최대 파일 크기를 확인합니다.
같은 미디어 처리 화면에서 GD·Imagick 사용 여부와 업로드할 이미지 형식의 지원 여부를 확인합니다.
파일시스템 권한 정보에서 uploads 디렉터리를 WordPress가 쓸 수 있는지 확인합니다.
미디어 > 새 미디어 파일 추가와 글 편집기의 이미지 블록에서 같은 비민감 테스트 파일을 각각 한 번 업로드해 실패 구간을 비교합니다.
수정 후 같은 계정·파일·업로드 화면에서 다시 실행하고, 미디어 라이브러리 등록과 생성된 이미지 크기를 확인합니다.
완료 판정
- 업로드 요청, PHP 제한, uploads 디렉터리, 이미지 처리 중 확인이 필요한 구간과 근거가 기록됩니다.
- 수정 후 같은 테스트 이미지가 미디어 라이브러리에 등록되고, WordPress가 해당 파일에 생성하도록 설정한 이미지 크기를 확인할 수 있습니다.
주의사항
변경 전 확인
- 원인을 확인하기 전에 uploads 디렉터리 권한이나 PHP 업로드 제한을 넓히지 않습니다.
- 원본 고객 이미지, 이미지 메타데이터, 서버 경로와 로그 전체를 공개 자료에 복사하지 않습니다.
담당자에게 전달할 내용
- WordPress·PHP 버전, 오류 원문, 발생 시각, 파일 형식·크기, Network 상태, 사이트 건강의 미디어 처리·파일시스템 권한 결과와 재검사 결과를 담당자에게 전달합니다.
적용 범위와 근거
워드프레스에서 이미지 업로드 오류가 보이면 화면 문구만으로 원인을 정하지 마세요. 업로드 요청이 거부됐는지, 원본은 저장됐지만 이미지 크기 생성이 실패했는지부터 구분해야 합니다.
확인 순서
- 미디어 라이브러리의 오류 문구와 발생 시각을 그대로 기록합니다. 테스트 이미지의 내용 대신 형식과 크기만 남깁니다.
- 브라우저 개발자 도구의 Network에서 업로드 요청 URL, HTTP 상태와 응답 문구를 확인합니다.
- WordPress 관리자에서
도구 > 사이트 건강 > 정보 > 미디어 처리를 엽니다. 파일 업로드 허용 여부, POST 최대 크기, 업로드 최대 크기, 유효 최대 파일 크기를 확인합니다. - 같은 화면에서 GD·Imagick 사용 여부와 지원 이미지 형식을 확인합니다.
파일시스템 권한에서 uploads 디렉터리를 WordPress가 쓸 수 있는지 확인합니다.- 같은 비민감 테스트 이미지를
미디어 > 새 미디어 파일 추가와 글 편집기의 이미지 블록에서 각각 한 번 업로드합니다.
WordPress는 두 화면에서 미디어 업로드를 지원합니다. 한 화면에서만 실패하면 해당 요청의 URL과 응답을 담당자에게 전달하고, 두 화면 모두 실패하면 공통 PHP·파일시스템 정보를 함께 확인합니다.
관찰 결과별 다음 확인
| 관찰 결과 | 우선 확인할 구간 | 다음 판단 |
|---|---|---|
| 사이트 건강에서 파일 업로드가 비활성화됨 | PHP file_uploads | 호스팅 담당자에게 현재 PHP 실행 환경을 확인합니다. |
| 테스트 이미지가 유효 최대 파일 크기보다 큼 | PHP post_max_size, upload_max_filesize | PHP 업로드 크기 제한 오류와 비교합니다. |
| uploads 디렉터리를 쓸 수 없음 | WordPress 파일시스템 권한 | 현재 권한과 실행 사용자를 기록한 뒤 호스팅 담당자에게 전달합니다. |
| 원본은 등록됐지만 필요한 이미지 크기가 없음 | GD·Imagick와 지원 이미지 형식 | 사이트 건강의 미디어 처리 정보와 서버 로그를 같은 시각으로 비교합니다. |
| PHP 정보는 정상인데 업로드가 완료되지 않음 | 업로드 요청과 임시·최종 저장 구간 | PHP 파일 업로드가 완료되지 않음에서 확인 범위를 좁힙니다. |
기록 양식
WordPress·PHP 버전:업로드 화면과 오류 원문:발생 시각:테스트 파일 형식·크기:Network 요청 URL·HTTP 상태·응답:사이트 건강의 미디어 처리 정보:uploads 디렉터리 쓰기 상태:수정 전 값과 변경한 항목:같은 조건의 재검사 결과:파일 업로드 전반의 시작점은 파일 업로드가 완료되지 않아요에서 확인할 수 있습니다. WordPress 공식 문서는 사이트 건강 화면 (새 창에서 열림)에서 미디어 처리와 파일시스템 권한을 확인하도록 안내하며, 미디어 설정 (새 창에서 열림)은 wp-content/uploads가 쓰기 가능한 경우 날짜별 디렉터리를 만든다고 설명합니다.
관련 오류·증상
관련 플랫폼
참고 자료
WordPress.org · 공식 자료 · 확인 범위: media-handling-diagnostics, filesystem-permissions · 확인일: 2026-08-29
WordPress.org · 공식 자료 · 확인 범위: upload-entry-points, wp-content-permissions · 확인일: 2026-08-29
WordPress.org · 공식 자료 · 확인 범위: uploads-directory-creation · 확인일: 2026-08-29
The PHP Group · 공식 자료 · 확인 범위: php-upload-limits · 확인일: 2026-08-29