워드프레스를 운영하다 보면 글에 이미지를 올리려는 순간 업로드가 멈추거나, “업로드 중 오류가 발생했습니다”, “서버에서 이미지를 처리할 수 없습니다”와 같은 안내가 나타날 수 있습니다.

이미지 파일이 정상적으로 보이는데도 워드프레스 미디어 라이브러리에 등록되지 않으면 파일 자체의 문제라고 생각하기 쉽습니다. 하지만 실제 원인은 파일 용량, 이미지 형식, 서버의 PHP 제한, 메모리 부족, 폴더 권한, 플러그인 충돌 등 여러 가지일 수 있습니다.

이번 글에서는 워드프레스 이미지 업로드 오류가 발생했을 때 초보자가 확인할 수 있는 항목을 쉬운 순서대로 설명하겠습니다. 처음부터 서버 파일을 수정하기보다, 간단한 테스트부터 진행하면 원인을 더 빠르게 찾을 수 있습니다.

1. 워드프레스 이미지 업로드 오류의 종류

화면에 나타나는 문구와 오류가 발생하는 시점을 확인하면 원인을 좁히는 데 도움이 됩니다.

오류 증상 가능한 원인 먼저 확인할 항목
파일 선택 후 업로드 실패 파일 용량 또는 형식 제한 이미지 크기와 확장자
서버에서 이미지를 처리할 수 없음 메모리 부족, 이미지 크기, 이미지 처리 모듈 문제 작은 이미지 업로드 테스트
업로드는 됐지만 미디어에 표시되지 않음 브라우저 캐시, 플러그인, 서버 응답 문제 새로고침과 다른 브라우저
썸네일 생성 실패 서버 이미지 처리 기능이나 메모리 문제 원본 이미지 크기와 PHP 환경
권한 오류 uploads 폴더 쓰기 권한 문제 호스팅 파일 권한과 소유자
특정 사용자만 업로드 실패 사용자 권한이나 사이트 설정 관리자 계정과 일반 계정 비교

2. 가장 먼저 작은 이미지로 테스트하세요

문제가 파일 자체에 있는지 사이트 환경에 있는지 구분하려면 작은 이미지로 테스트하는 것이 가장 쉽습니다. 휴대전화 사진처럼 용량이 큰 원본 대신 가로 폭이 작고 용량이 낮은 JPEG 또는 PNG 이미지 하나를 준비하세요.

  1. 워드프레스 관리자 화면에서 미디어 → 새 미디어 파일 추가로 이동합니다.
  2. 작은 JPEG 이미지 하나를 선택합니다.
  3. 업로드가 완료되는지 확인합니다.
  4. 같은 화면에서 큰 원본 이미지를 다시 테스트합니다.

작은 이미지는 올라가고 큰 이미지에서만 실패한다면 파일 크기나 이미지 처리 용량이 원인일 가능성이 높습니다. 작은 이미지도 업로드되지 않는다면 파일 형식, 폴더 권한, 플러그인, 서버 연결 문제를 추가로 확인해야 합니다.

3. 업로드 가능한 최대 용량을 확인하세요

워드프레스에는 서버가 허용하는 파일 업로드 용량이 있습니다. 이미지가 아무리 정상이어도 이 제한을 넘으면 업로드할 수 없습니다.

관리자 화면에서 미디어 → 새 미디어 파일 추가로 이동하면 화면에 최대 업로드 파일 크기가 표시되는 경우가 많습니다. 이미지 파일의 용량이 표시된 제한보다 큰지 먼저 확인하세요.

  • 이미지 파일의 실제 용량을 확인합니다.
  • 워드프레스 화면의 최대 업로드 크기와 비교합니다.
  • 제한보다 큰 이미지는 크기를 줄이거나 압축합니다.
  • 대용량 이미지는 원본을 그대로 올리지 않습니다.

휴대전화로 촬영한 사진은 화면에 보이는 크기보다 파일 용량이 큰 경우가 많습니다. 블로그 본문에 표시할 크기보다 지나치게 큰 사진이라면 이미지 편집 프로그램이나 온라인 도구를 이용해 가로 폭과 용량을 줄인 뒤 업로드하세요.

서버 설정에는 보통 upload_max_filesize와 post_max_size라는 제한이 사용됩니다. 두 값 중 실제로 적용되는 더 작은 제한에 따라 업로드 가능 용량이 결정될 수 있습니다. 이 설정은 호스팅 업체의 PHP 환경에서 관리되므로 초보자가 직접 변경하기보다 업체에 조정을 문의하는 것이 안전합니다.

4. 이미지 형식과 파일 상태를 확인하세요

워드프레스는 일반적으로 JPEG, PNG, GIF, WebP와 같은 이미지 형식을 많이 사용합니다. 그러나 이미지 파일의 확장자만 바뀌어 있고 실제 내부 형식이 다르거나, 파일이 손상되었다면 업로드 과정에서 오류가 발생할 수 있습니다.

다음과 같은 경우에는 다른 형식으로 다시 저장해 보세요.

  • 사진 편집 프로그램에서 저장이 완료되지 않은 파일
  • 메신저나 일부 앱에서 변환된 특수 이미지 파일
  • 파일 확장자만 임의로 변경한 이미지
  • 열 때부터 미리보기가 정상적으로 표시되지 않는 이미지
  • 너무 큰 파노라마나 고해상도 원본 사진

이미지가 컴퓨터에서 정상적으로 열리더라도 새 파일로 다시 저장하면 문제가 해결되는 경우가 있습니다. JPEG나 PNG로 새롭게 저장한 뒤 업로드해 보세요.

파일 이름도 단순하게 정리하는 것이 좋습니다. 한글 파일명이 항상 문제를 일으키는 것은 아니지만, 서버나 외부 플러그인과의 호환성을 고려하면 영문과 숫자, 대시를 사용한 파일명이 관리하기 편합니다. 예를 들어 wordpress-image-01.jpg처럼 작성할 수 있습니다.

5. “서버에서 이미지를 처리할 수 없습니다” 오류

이미지가 미디어 라이브러리에 올라간 뒤 썸네일을 만들거나 크기를 조정하는 과정에서 “서버에서 이미지를 처리할 수 없습니다”라는 안내가 나타날 수 있습니다.

이 오류는 워드프레스가 원본 이미지를 여러 크기로 변환하는 과정에서 서버 메모리나 이미지 처리 기능을 충분히 사용하지 못할 때 발생할 수 있습니다. 특히 가로와 세로가 매우 큰 사진, 용량이 큰 스마트폰 원본, 파노라마 이미지에서 자주 확인됩니다.

다음 순서로 점검해 보세요.

  1. 이미지의 가로 폭을 줄여 새 파일로 저장합니다.
  2. 파일 용량을 낮춘 JPEG 또는 PNG로 다시 저장합니다.
  3. 작은 이미지가 정상적으로 처리되는지 확인합니다.
  4. 이미지 최적화 플러그인을 잠시 비활성화합니다.
  5. 호스팅 업체에 PHP 메모리와 이미지 처리 모듈을 문의합니다.

작은 이미지는 정상적으로 올라가는데 특정 고해상도 이미지에서만 오류가 발생한다면 이미지 크기를 줄이는 것이 가장 빠른 해결 방법입니다. 모든 이미지에서 오류가 발생한다면 서버 환경이나 플러그인을 확인해야 합니다.

6. 미디어 라이브러리 폴더 권한 확인

워드프레스는 업로드한 파일을 일반적으로 wp-content/uploads 폴더 안에 저장합니다. 서버가 이 폴더에 파일을 기록할 권한이 없으면 업로드가 실패하거나 미디어 라이브러리에서 이미지가 보이지 않을 수 있습니다.

권한 문제로 의심되는 상황은 다음과 같습니다.

  • 모든 이미지 업로드가 계속 실패합니다.
  • 서버를 이전한 뒤부터 업로드되지 않습니다.
  • 호스팅 파일 관리자에서 uploads 폴더가 읽기 전용으로 표시됩니다.
  • “디렉터리를 만들 수 없습니다”와 같은 문구가 나타납니다.

파일 권한은 서버 환경과 소유자 설정에 따라 달라질 수 있습니다. 인터넷에 있는 숫자 값을 무조건 적용하거나 보안을 약화시키는 방식으로 권한을 변경하지 마세요. 호스팅 업체에 wp-content/uploads 폴더에 워드프레스가 파일을 저장할 수 있는 권한이 있는지 확인해 달라고 요청하는 것이 안전합니다.

7. 브라우저 업로더로 다시 시도해 보세요

워드프레스의 기본 업로더가 브라우저와 충돌하거나 자바스크립트 오류가 발생하면 파일 선택 화면이 정상적으로 작동하지 않을 수 있습니다.

미디어 추가 화면에 일반 업로더 또는 브라우저 업로더로 전환하는 링크가 표시된다면 다른 업로드 방식을 사용해 보세요. 한 방식에서는 실패하지만 다른 방식에서는 정상적으로 올라가는 경우 브라우저나 화면 스크립트 문제일 수 있습니다.

다음 방법도 함께 시도할 수 있습니다.

  • 시크릿 창에서 관리자 화면을 엽니다.
  • 다른 브라우저를 사용합니다.
  • 브라우저 확장 프로그램을 잠시 끕니다.
  • 관리자 화면의 캐시와 쿠키를 삭제합니다.
  • 인터넷 연결을 바꿔 다시 시도합니다.

8. 플러그인이나 테마 충돌 확인

이미지 최적화, 캐시, 보안, 갤러리, 미디어 관리 플러그인은 업로드 과정에 영향을 줄 수 있습니다. 플러그인을 설치하거나 업데이트한 직후부터 이미지 업로드가 실패했다면 최근 변경한 플러그인을 먼저 확인하세요.

  1. 최근 설치하거나 업데이트한 플러그인을 기록합니다.
  2. 해당 플러그인을 잠시 비활성화합니다.
  3. 작은 이미지와 큰 이미지를 각각 테스트합니다.
  4. 문제가 사라지면 플러그인의 호환성과 설정을 확인합니다.
  5. 필요하다면 제작자의 지원 게시판에서 오류 내용을 검색합니다.

모든 플러그인을 한꺼번에 삭제하지 말고 하나씩 비활성화하세요. 어떤 플러그인이 원인인지 확인하려면 변경 후 같은 이미지로 테스트해야 합니다.

플러그인을 모두 비활성화했는데도 문제가 계속되면 테마나 서버 환경을 확인합니다. 테스트가 끝나면 필요한 플러그인을 하나씩 다시 활성화하고, 이미지 업로드가 정상적으로 유지되는지 확인하세요.

9. 이미지 업로드는 되지만 글에 표시되지 않을 때

미디어 라이브러리에는 이미지가 보이는데 글 본문에 표시되지 않는 경우도 있습니다. 이때는 이미지 업로드 자체보다 이미지 주소나 본문 편집 화면의 문제일 수 있습니다.

  • 글에 삽입된 이미지 주소가 현재 도메인과 일치하는지 확인합니다.
  • 이미지 주소에 http와 https가 섞여 있지 않은지 확인합니다.
  • 이미지 정렬과 크기 설정이 화면 밖으로 밀어내지 않는지 확인합니다.
  • 캐시를 비우고 다른 브라우저에서 글을 확인합니다.
  • 테마의 CSS가 이미지를 숨기고 있지 않은지 확인합니다.

도메인이나 SSL을 변경한 뒤 이미지가 보이지 않는다면 기존 이미지 주소가 예전 도메인을 가리키고 있을 수 있습니다. 이 경우 사이트 주소와 이미지 URL을 점검하고, 여러 글의 주소를 한꺼번에 바꾸기 전에는 반드시 백업을 준비하세요.

10. FTP로 이미지를 올리는 방법은 신중하게 사용하세요

워드프레스 관리자 화면이 계속 오류를 내면 FTP로 파일을 서버에 올리는 방법을 생각할 수 있습니다. 그러나 FTP로 파일을 올렸다고 해서 자동으로 미디어 라이브러리에 등록되는 것은 아닙니다.

단순히 uploads 폴더에 파일을 복사하면 실제 파일은 서버에 존재하지만, 워드프레스 데이터베이스에 미디어 정보가 등록되지 않을 수 있습니다. 따라서 일반적인 블로그 운영에서는 먼저 관리자 화면의 미디어 업로드를 정상화하는 것이 좋습니다.

FTP 업로드는 서버에 남아 있는 파일 확인이나 복구 작업에 사용하고, 미디어 라이브러리에 등록해야 하는 이미지는 워드프레스가 제공하는 업로드 기능으로 처리하세요.

11. 호스팅 업체에 문의할 때 전달할 정보

서버 설정 문제로 판단되면 호스팅 업체에 정확한 정보를 전달해야 빠른 확인이 가능합니다. 다음 내용을 함께 적어 보내세요.

  • 오류가 발생한 날짜와 시간
  • 사용한 이미지 확장자와 대략적인 용량
  • 표시된 오류 문구 전체
  • 작은 이미지도 실패하는지 여부
  • 최근 도메인, PHP, 플러그인 변경 여부
  • 관리자 화면과 홈페이지의 다른 오류 여부
  • 오류가 발생하는 워드프레스 주소

“이미지가 안 올라갑니다”라고만 문의하기보다 “1MB JPEG는 올라가지만 8MB 이미지에서 서버 처리 오류가 발생한다”처럼 재현 조건을 설명하면 원인을 파악하기 쉽습니다.

12. 이미지 업로드 오류를 예방하는 관리 습관

이미지를 올리기 전에 블로그에 필요한 크기로 줄이면 업로드 오류와 페이지 로딩 부담을 함께 줄일 수 있습니다.

  • 원본 사진을 그대로 업로드하지 않습니다.
  • 본문에 표시할 크기에 맞춰 이미지 폭을 조절합니다.
  • 업로드 전 파일 용량을 확인합니다.
  • 일반적인 JPEG, PNG, WebP 형식을 우선 사용합니다.
  • 이미지 최적화 플러그인은 한 번에 여러 개 사용하지 않습니다.
  • 대량 업로드 전 작은 수량으로 테스트합니다.
  • 중요한 이미지와 사이트 데이터는 정기적으로 백업합니다.

이미지 품질을 지나치게 낮추면 글의 가독성이 떨어질 수 있으므로, 용량과 화질 사이의 균형을 맞추는 것이 좋습니다. 블로그 본문용 사진은 원본 보관용 파일과 웹 게시용 파일을 따로 관리하면 편리합니다.

마무리

워드프레스 이미지 업로드 오류는 파일 용량, 형식, 서버 제한, 이미지 처리 메모리, 폴더 권한, 플러그인 충돌 등 여러 원인으로 발생할 수 있습니다.

가장 먼저 작은 이미지로 테스트해 오류가 파일 크기 문제인지 사이트 전체 문제인지 구분하세요. 이후 최대 업로드 용량, 이미지 형식, 브라우저, 플러그인, uploads 폴더 권한 순서로 확인하면 원인을 찾기 쉽습니다.

서버 파일과 권한을 직접 수정하기 전에는 백업을 준비하고, 정확한 원인을 모를 때는 호스팅 업체에 오류 문구와 재현 조건을 전달하는 것이 안전합니다. 이미지를 적절한 크기로 줄이고 필요한 플러그인만 사용하면 업로드 오류를 줄이면서 사이트 속도 관리에도 도움이 됩니다.


참고 자료

사이트노트

글에 대한 의견이나 정정 요청은 문의하기로 보내주세요.

문의하기