워드프레스 이미지 업로드 오류 해결, 사진이 안 올라갈 때 확인할 것

워드프레스 이미지 업로드 오류 해결, 사진이 안 올라갈 때 확인할 것

워드프레스 이미지 업로드 오류는 같은 증상처럼 보여도 원인이 여러 가지입니다.

이미지 용량이 너무 클 수도 있고, 서버에서 허용한 업로드 크기를 넘었거나, 파일 형식·플러그인·PHP 설정 때문에 업로드가 막힐 수도 있습니다.

WordPress는 업로드 과정에서 파일 이름과 확장자, MIME 유형 등을 확인한 뒤 서버의 업로드 디렉터리로 파일을 이동합니다. 따라서 단순히 브라우저에서 파일을 선택했다고 바로 등록되는 구조는 아닙니다.

오류가 발생하면 처음부터 워드프레스를 다시 설치하기보다 파일 문제인지, 사이트 전체의 업로드 문제인지부터 구분​하는 것이 좋습니다.

1. 가장 먼저 다른 이미지 하나를 올려보기

먼저 오류가 특정 파일에서만 발생하는지 확인합니다.

예를 들어 문제가 생긴 이미지 대신

  • 작은 JPG
  • 작은 PNG
  • 기존에 정상적으로 올렸던 이미지와 비슷한 파일

을 하나 업로드해보세요.

결과가 다음처럼 나뉩니다.

다른 이미지는 정상 업로드됨
→ 기존 이미지의 용량·형식·파일명 문제 가능성이 큽니다.

모든 이미지가 업로드되지 않음
→ 서버 설정, 플러그인, 권한 또는 WordPress 환경을 확인해야 합니다.

이 테스트만 해도 문제 범위를 상당히 줄일 수 있습니다.

2. 미디어 라이브러리에서 직접 업로드해보기

글 편집 화면에서만 이미지 업로드가 안 된다면 미디어 라이브러리에서 별도로 테스트합니다.

워드프레스 관리자에서

미디어 → 새 미디어 파일 추가

로 이동합니다.

WordPress 공식 문서에서도 미디어 라이브러리를 통해 파일을 업로드하고 관리할 수 있다고 안내합니다.

미디어 라이브러리에서는 정상인데 글 편집 화면에서만 실패한다면 편집기나 특정 블록·플러그인 쪽 문제를 의심할 수 있습니다.

3. 업로드 가능한 최대 파일 크기 확인하기

큰 이미지에서만 문제가 생긴다면 가장 먼저 서버의 업로드 제한을 확인합니다.

WordPress의 최대 업로드 크기는 PHP 설정의

  • upload_max_filesize
  • post_max_size

등에 영향을 받습니다.

WordPress 개발자 문서에 따르면 실제 최대 업로드 크기는 upload_max_filesize와 post_max_size를 기준으로 결정됩니다.

또한 post_max_size는 upload_max_filesize보다 같거나 크게 설정되어야 합니다.

예를 들어

  • 이미지: 12MB
  • 사이트 최대 업로드 크기: 10MB

라면 그대로는 업로드할 수 없습니다.

4. 최대 업로드 용량은 어디서 확인할까

워드프레스에서는 보통

미디어 → 새 미디어 파일 추가

화면 하단에서 최대 업로드 파일 크기를 확인할 수 있습니다.

사이트 환경에 따라

최대 업로드 파일 크기: 20MB

같은 식으로 표시됩니다.

현재 이미지 크기가 이 값을 넘는다면 먼저 이미지를 줄이거나 서버 설정을 변경해야 합니다.

5. 이미지 용량부터 줄여보기

스마트폰 사진이나 고해상도 이미지 파일은 한 장만으로도 수 MB에서 수십 MB까지 커질 수 있습니다.

웹사이트에 사용하는 대표이미지라면 원본 카메라 해상도를 그대로 유지할 필요가 없는 경우가 많습니다.

먼저

  • 가로·세로 크기 축소
  • JPG 품질 조정
  • WebP 등 웹용 이미지 사용
  • 불필요한 메타데이터 제거

등으로 파일을 줄인 뒤 다시 올려봅니다.

특정 대용량 파일만 실패하고 작은 이미지는 정상이라면 이 방법을 먼저 쓰는 것이 간단합니다.

6. 이미지 픽셀 크기가 지나치게 큰 경우

파일 용량뿐 아니라 이미지 해상도 자체가 너무 큰 경우에도 서버에서 이미지 처리 과정이 부담될 수 있습니다.

예를 들어

12000 × 8000px

같은 원본 사진은 웹페이지 대표이미지로는 지나치게 클 수 있습니다.

이미지를 사이트에서 실제 사용할 정도로 줄여서 다시 업로드해보세요.

대표이미지가 16:9 비율이라면 사이트 디자인에 맞는 적당한 가로 크기로 미리 리사이즈해두는 것도 좋습니다.

7. “서버에서 이미지를 처리할 수 없습니다”가 뜰 때

이미지 업로드는 완료됐지만 WordPress가 썸네일이나 여러 크기의 이미지를 생성하는 과정에서 실패할 수 있습니다.

WordPress 미디어 설정은 이미지 크기 생성 기능과 관련되어 있으며, 서버에서는 이미지 처리를 위한 그래픽 라이브러리를 사용합니다. WordPress 공식 문서는 관련 이미지 기능에 GD 그래픽 라이브러리가 필요할 수 있다고 설명합니다.

이 메시지가 특정 고해상도 이미지에서만 나타난다면 먼저 이미지 크기와 용량을 줄여 다시 시도해보세요.

모든 이미지에서 반복된다면 서버의 이미지 처리 환경도 확인해야 합니다.

8. HTTP 오류가 뜰 때

업로드 중 단순히

HTTP 오류

라고만 표시되는 경우도 있습니다.

이 문구만으로는 정확한 원인을 하나로 확정하기 어렵습니다.

다음 순서로 확인하세요.

  1. 다른 작은 이미지 업로드
  2. 파일명 변경
  3. 이미지 용량 축소
  4. 브라우저 새로고침
  5. 로그아웃 후 재로그인
  6. 플러그인 충돌 확인
  7. 서버 PHP 제한 확인

HTTP 오류는 서버 통신부터 이미지 처리 단계까지 여러 원인으로 나타날 수 있기 때문에 하나씩 범위를 좁히는 것이 좋습니다.

9. 파일 형식 확인하기

파일 확장자와 실제 파일 형식이 맞지 않으면 업로드에 문제가 생길 수 있습니다.

예를 들어 파일 이름만 .jpg로 바꿨다고 해서 다른 형식의 파일이 JPG로 변환되는 것은 아닙니다.

WordPress 업로드 처리 과정에서는 확장자와 MIME 유형을 확인합니다.

따라서 출처가 불분명한 이미지라면 이미지 편집 프로그램에서 다시 열어

  • JPG
  • PNG
  • WebP

등 일반적인 웹 이미지 형식으로 새로 저장해보세요.

10. 파일명을 단순하게 바꿔보기

특정 이미지 하나만 업로드되지 않는다면 파일명을 바꿔보는 것도 간단한 테스트입니다.

예를 들어

최종수정(진짜최종)_대표이미지!! 01.jpg

보다는

wordpress-image-upload.jpg

처럼 단순하게 바꿔보세요.

특수문자나 지나치게 긴 파일명이 직접적인 원인이라고 단정할 수는 없지만, 서버나 플러그인 환경에 따라 파일 처리 과정에서 문제를 줄이는 데 도움이 될 수 있습니다.

11. 브라우저 문제인지 확인하기

현재 브라우저에서만 업로드가 안 되는지도 확인합니다.

먼저

  • 페이지 새로고침
  • 워드프레스 로그아웃 후 로그인
  • 시크릿 창에서 관리자 접속
  • 다른 브라우저에서 업로드

를 테스트합니다.

다른 브라우저에서는 정상적으로 올라간다면 서버 전체 문제보다 현재 브라우저의 캐시나 확장프로그램 영향을 의심할 수 있습니다.

12. 플러그인 충돌 확인하기

이미지 최적화, 보안, 캐시, CDN 관련 플러그인은 파일 업로드 과정에 관여할 수 있습니다.

최근 플러그인을 설치하거나 업데이트한 직후 문제가 시작됐다면 특히 확인해볼 필요가 있습니다.

테스트할 때는 사이트 백업을 확인한 뒤 의심되는 플러그인부터 잠시 비활성화합니다.

예를 들면

  • 이미지 압축 플러그인
  • WebP 변환 플러그인
  • 보안 플러그인
  • 캐시 플러그인
  • 미디어 관리 플러그인

등입니다.

플러그인을 끈 상태에서 업로드가 정상적으로 된다면 원인을 좁힐 수 있습니다.

13. 테마 문제인지도 구분할 수 있다

플러그인을 모두 확인했는데 문제를 찾지 못했다면 테마와의 충돌 여부도 검토할 수 있습니다.

다만 운영 중인 사이트라면 바로 테마를 변경하지 않는 것이 좋습니다.

먼저 백업을 만들고 가능하다면 스테이징 환경에서 기본 WordPress 테마로 테스트하는 방식이 안전합니다.

이미지 하나가 안 올라간다는 이유로 실제 운영 사이트의 테마부터 변경하는 것은 권장하지 않습니다.

14. 서버 저장공간이 부족한 경우

호스팅 계정의 디스크 공간이 부족하면 새 파일을 저장할 수 없기 때문에 미디어 업로드가 실패할 수 있습니다.

WordPress 자체의 미디어 라이브러리 용량과 별개로 호스팅 서버 전체 저장공간도 확인해야 합니다.

특히

  • 이미지가 많이 쌓인 사이트
  • 자동 백업 파일이 많은 사이트
  • 캐시 파일이 커진 사이트
  • 영상이나 대용량 파일을 직접 저장한 사이트

라면 확인할 필요가 있습니다.

호스팅 관리 화면에서 디스크 사용량을 확인하세요.

15. PHP upload_max_filesize 확인하기

서버에서 개별 파일 업로드 크기를 제한하는 대표 설정이

upload_max_filesize

입니다.

WordPress 개발자 문서는 이 값을 개별 파일 업로드 최대 크기를 제어하는 PHP 설정으로 설명합니다.

예를 들어 서버 설정이

upload_max_filesize = 8M

이라면 15MB 이미지는 업로드되지 않을 수 있습니다.

사용 중인 호스팅 업체의 PHP 설정 화면에서 값을 조절할 수 있는지 확인합니다.

16. post_max_size도 함께 확인하기

upload_max_filesize만 올렸는데 여전히 업로드가 안 되는 경우가 있습니다.

전체 요청 크기를 제한하는

post_max_size

도 함께 확인해야 하기 때문입니다.

WordPress 개발자 문서에서는 post_max_size가 upload_max_filesize보다 같거나 더 크게 설정되어야 한다고 설명합니다.

예를 들어

upload_max_filesize = 64M

인데

post_max_size = 8M

라면 설정이 맞지 않습니다.

17. PHP 메모리 부족 문제

큰 이미지를 업로드하면 단순히 파일을 서버로 전송하는 것에서 끝나지 않습니다.

WordPress는 이미지 크기를 조절하고 썸네일 등을 만드는 작업을 수행할 수 있기 때문에 처리 과정에서 메모리가 필요합니다.

WordPress 공식 문서에서도 큰 파일 처리 과정에서 서버 메모리가 부족하면 오류가 발생할 수 있다고 설명합니다.

특히 작은 이미지는 되는데 매우 큰 이미지만 처리 실패한다면 이미지 크기를 줄여 테스트하는 것이 좋습니다.

18. 업로드 폴더 권한 문제

WordPress는 업로드한 파일을 서버의 업로드 디렉터리에 저장해야 합니다.

서버가 해당 디렉터리에 파일을 쓸 수 없는 상태라면 업로드가 실패할 수 있습니다.

WordPress의 업로드 처리 함수도 파일을 서버의 업로드 디렉터리로 이동하는 과정을 포함합니다.

FTP나 호스팅 파일 관리자를 직접 다뤄야 하는 영역이므로 익숙하지 않다면 권한 값을 임의로 변경하기보다 호스팅 업체 지원을 이용하는 편이 안전합니다.

19. 403 오류가 함께 뜨는 경우

업로드 과정에서 403 Forbidden이 표시된다면 단순한 이미지 크기 문제와 다를 수 있습니다.

WordPress 공식 설치 FAQ는 403 오류의 원인 중 하나로 서버 권한이나 파일 시스템 접근 문제를 안내합니다.

이 경우에는

  • 보안 플러그인
  • 서버 방화벽
  • 파일 권한
  • 호스팅 보안 정책

등을 확인해야 합니다.

20. 413 오류가 뜬다면 파일 크기 제한 확인하기

413 Request Entity Too Large와 비슷한 오류가 나타난다면 서버가 요청 크기를 너무 크다고 판단한 경우를 먼저 의심해야 합니다.

이때는 단순히 이미지를 다시 선택하는 것보다

  • 파일 용량 줄이기
  • PHP 업로드 제한
  • 웹 서버 요청 크기 제한

등을 확인해야 합니다.

WordPress 환경에서 실제 허용 업로드 크기는 PHP 설정과 서버 구성의 영향을 받습니다.

21. 사이트 건강 상태 확인하기

WordPress에는 사이트 건강 기능이 있습니다.

관리자 메뉴에서

도구 → 사이트 건강

으로 이동합니다.

WordPress의 Site Health 기능은 서버의 파일 업로드 관련 설정을 포함해 사이트 환경을 점검할 수 있습니다. WordPress 개발자 문서에서도 upload_max_filesizepost_max_size 등 업로드 관련 값을 검사합니다.

여기에서 권장 개선 사항이나 치명적인 문제가 표시되는지 확인하세요.

22. 워드프레스·플러그인 업데이트도 확인하기

오래된 WordPress 코어나 플러그인을 사용하고 있다면 현재 버전을 확인합니다.

다만 오류를 해결하겠다고 바로 모든 것을 한꺼번에 업데이트하는 것보다는 백업을 먼저 만든 뒤 하나씩 진행하는 편이 좋습니다.

업데이트 여러 개를 동시에 적용하면 문제가 해결됐을 때 무엇이 원인이었는지 알기 어려워집니다.

23. 이미지가 미디어 라이브러리에 있는데 글에서는 안 보이는 경우

업로드 자체는 성공했지만 글 편집 화면에서 이미지가 안 보이는 경우라면 업로드 실패와 다른 문제입니다.

먼저

미디어 → 라이브러리

에서 이미지가 실제 등록되어 있는지 확인하세요.

WordPress 미디어 라이브러리는 이미 업로드한 미디어를 확인·편집·삭제할 수 있는 관리 화면입니다.

라이브러리에 정상적으로 있다면 글의 이미지 블록이나 URL, 캐시 문제를 따로 확인해야 합니다.

24. 업로드를 반복하기 전에 같은 이미지가 여러 개 생겼는지 확인하기

오류 메시지가 떴다고 해서 항상 업로드가 완전히 실패한 것은 아닙니다.

서버에는 이미지가 등록됐지만 후처리 과정에서 오류가 발생한 경우 미디어 라이브러리에 같은 파일이 여러 개 생길 수도 있습니다.

재시도하기 전에 미디어 라이브러리를 확인해 중복 파일이 있는지 살펴보세요.

오류별 빠른 확인표

증상먼저 확인할 것
큰 이미지만 안 올라감파일 용량·픽셀 크기·PHP 제한
모든 이미지가 안 올라감서버·플러그인·권한
HTTP 오류파일 크기·플러그인·서버 설정
서버에서 이미지 처리 불가이미지 해상도·메모리·이미지 처리 환경
413 오류업로드·요청 크기 제한
403 오류보안 설정·서버 권한
미디어에는 있는데 글에서 안 보임이미지 블록·캐시
특정 브라우저에서만 실패브라우저·확장프로그램

워드프레스 이미지 업로드 오류 해결 순서

원인을 모르겠다면 아래 순서대로 확인하세요.

  1. 작은 JPG 이미지 하나 업로드
  2. 특정 파일만 문제인지 확인
  3. 이미지 파일 용량 확인
  4. 픽셀 크기가 너무 크다면 축소
  5. 파일명과 형식 확인
  6. 미디어 라이브러리에서 직접 업로드
  7. 다른 브라우저에서 테스트
  8. 최근 설치한 플러그인 확인
  9. 호스팅 저장공간 확인
  10. upload_max_filesize와 post_max_size 확인
  11. 사이트 건강 상태 확인
  12. 계속 실패하면 호스팅 서버 권한·PHP 환경 확인

워드프레스 이미지 업로드 오류가 발생하면 가장 먼저 작은 정상 이미지가 올라가는지 확인하는 것이 중요합니다.

작은 이미지는 정상인데 큰 이미지만 실패한다면 서버 업로드 제한이나 이미지 크기 문제부터 확인하면 되고, 모든 이미지가 실패한다면 플러그인·서버·권한 쪽으로 범위를 넓히면 됩니다.

특히 WordPress의 최대 업로드 크기는 PHP의 upload_max_filesize와 post_max_size 같은 서버 설정에 영향을 받기 때문에, 파일 자체를 줄여도 계속 문제가 발생한다면 호스팅 설정까지 확인해야 합니다.