워드프레스 이미지 업로드 오류, 비전공자가 직접 고친 해결법 7가지

글 발행 직전에 스크린샷을 올리는데 빨간 글씨로 ‘HTTP 오류’가 떴다면, 그 막막함 저도 정확히 알아요. 결론부터 말하면 워드프레스 이미지 업로드 오류의 대부분은 파일명·용량·폴더 권한 세 가지 안에서 해결돼요. 저는 코딩을 모르는 상태에서 Claude Code에 오류 메시지를 붙여넣어 가며 원인을 하나씩 지워봤고, 결국 서버를 건드리지 않고도 문제를 잡았어요. 이 글에는 그 삽질 과정을 순서 그대로 담았으니, 쉬운 것부터 따라 하다 보면 어느 단계에서든 해결 지점을 만나실 거예요.

• 1. 오류 메시지부터 확인 — 증상별 빠른 진단표
• 2. 5분 안에 끝나는 쉬운 해결책 4가지
• 3. 업로드 용량·메모리 한도 늘리는 3가지 방법
• 4. ‘파일을 옮길 수 없습니다’ — uploads 폴더 권한 확인
• 5. 플러그인 충돌·PHP 버전·이미지 처리 오류 점검
• 6. 그래도 안 되면 — 호스팅 설정 확인과 문의 요령
• 7. 증상별 최종 체크리스트와 재발 방지 습관
• 자주 묻는 질문

1. 오류 메시지부터 확인 — 증상별 빠른 진단표

지난주에 실습 기록 글을 쓰다가 스크린샷을 올리는 순간 ‘HTTP 오류’를 처음 만났어요. 서버를 만져본 적이 없으니 사이트가 망가진 줄 알고 한참 멍했죠. 그런데 Claude Code에 오류 문구를 그대로 붙여넣고 물어보니 원인 후보를 순서대로 짚어줬고, 결국 30분 만에 해결했어요.

먼저 알아둘 점이 있어요. 워드프레스는 같은 업로드 실패라도 메시지가 다르게 떠요. 그리고 이 메시지가 원인의 절반을 알려줘요. 아래 진단표에서 내 화면에 뜬 문구부터 찾고, 해당 섹션으로 바로 이동하세요.

2. 5분 안에 끝나는 쉬운 해결책 4가지

설정 파일을 건드리기 전에 아래 네 가지부터 순서대로 해보세요. 제 경우를 포함해 초보자가 만나는 미디어 라이브러리 오류의 절반 이상이 여기서 끝나요.

1. 파일명을 영문과 숫자로 바꾸기 — 한글·공백·괄호가 섞인 파일명은 서버 환경에 따라 처리에 실패해요. 제 범인도 ‘완성 화면(최종).png’라는 파일명이었어요. ‘final-screen.png’로 바꾸니 그대로 올라갔어요.
2. 이미지 용량 줄이기 — 스마트폰 원본은 가로 4000픽셀에 5MB를 훌쩍 넘어요. 블로그용은 가로 1200~1600픽셀, 500KB 이하면 충분해요. 맥은 미리보기, 윈도우는 그림판의 크기 조정 기능으로 줄일 수 있어요.
3. 브라우저 캐시 삭제 후 시크릿 창에서 재시도 — 파일은 멀쩡한데 화면 쪽이 꼬인 경우도 의외로 많아요. 엑박 현상이라면 특히 이것부터 해보세요.
4. 몇 분 뒤 다시 업로드 — 서버가 순간적으로 바빠서 실패하는 간헐적 HTTP 에러도 있어요. 두세 번 반복해도 실패하면 다음 섹션으로 넘어가요.

3. 업로드 용량·메모리 한도 늘리는 3가지 방법

쉬운 방법으로 안 되면 파일 용량 제한을 의심할 차례예요. 관리자에서 미디어 > 파일 올리기로 들어가면 화면 아래에 ‘최대 업로드 파일 크기’가 보여요. 이 숫자보다 큰 파일은 무조건 실패해요.

이 한도는 워드프레스가 아니라 서버의 PHP 설정이 정해요. 그래서 아래 파일 중 하나를 수정해 최대 크기를 늘려요. 셋 다 할 필요는 없고, 접근 가능한 것 하나면 돼요.

셋 중 뭘 써야 할지 모르겠으면 호스팅 관리자 페이지에서 PHP 설정 메뉴부터 찾아보세요. 파일을 열 필요 없이 클릭 몇 번으로 끝나는 경우가 가장 많아요.

4. ‘파일을 옮길 수 없습니다’ — uploads 폴더 권한 확인

‘업로드한 파일을 wp-content/uploads로 이동할 수 없습니다’라는 메시지는 용량 문제가 아니에요. 서버가 그 폴더에 파일을 쓸 권한이 없다는 뜻이에요. 퍼미션이라는 말이 어렵게 들리는데, 폴더마다 붙는 ‘누가 읽고 쓸 수 있는지’ 표시라고 생각하면 돼요. 숫자 755는 소유자는 전부 가능하고 나머지는 읽기만 되는 조합이에요.

1. 파일질라 같은 무료 FTP 프로그램으로 서버에 접속해요. 접속 주소와 비밀번호는 호스팅 가입 안내 메일이나 관리자 페이지에 있어요.
2. wp-content 폴더 안의 uploads 폴더를 우클릭하고 ‘파일 권한’ 메뉴를 열어요.
3. 폴더는 755, 파일은 644인지 확인하고 다르면 숫자를 고쳐요.
4. ‘하위 디렉터리에 적용’ 옵션을 체크하면 연도·월별 하위 폴더까지 한 번에 정리돼요.

5. 플러그인 충돌·PHP 버전·이미지 처리 오류 점검

여기까지 했는데도 실패하면 워드프레스 내부의 충돌을 의심할 차례예요. 저는 이 단계에서 이미지 최적화 플러그인이 범인인 걸 찾았어요. 다만 플러그인을 켠 채로 계속 테스트하다 한 시간을 날렸으니, 반드시 전부 끄고 시작하세요.

1. 플러그인 전체 비활성화 후 업로드 테스트 — 성공하면 플러그인 충돌이 확정이에요. 하나씩 다시 켜면서 매번 업로드해 보면 범인이 좁혀져요. 보안·이미지 압축·캐시 계열 플러그인이 특히 자주 걸려요.
2. 기본 테마로 잠시 전환 — Twenty 시리즈 같은 기본 테마로 바꿔 업로드해 보면 테마 문제인지 배제할 수 있어요. 확인 후 원래 테마로 되돌리면 돼요.
3. PHP 버전 확인 — 관리자에서 도구 > 사이트 건강 > 정보 탭을 열면 서버의 PHP 버전이 보여요. 오래된 버전은 오류의 단골 원인이라, 호스팅 관리자 페이지에서 워드프레스 권장 버전으로 올리는 게 좋아요. 권장 버전은 워드프레스 공식 문서에서 확인하세요.
4. ‘서버가 이미지를 처리할 수 없습니다’가 떴다면 — 이미지 처리 담당인 Imagick 확장이 리소스 부족으로 멈춘 경우가 많아요. 테마의 functions.php에 아래 한 줄을 넣어 GD 라이브러리를 우선 쓰게 하면 넘어가는 경우가 있어요.

add_filter('wp_image_editors', function() {
  return ['WP_Image_Editor_GD', 'WP_Image_Editor_Imagick'];
});

이 코드도 넣기 전에 functions.php 원본을 복사해 두고, 문제가 해결되면 그대로 둬도 괜찮아요. 이미지가 유난히 크면 코드 이전에 가로 폭부터 줄이는 게 더 빠른 해결일 때도 많아요.

6. 그래도 안 되면 — 호스팅 설정 확인과 문의 요령

공유 호스팅에서는 php.ini를 직접 수정하지 못하게 막아둔 경우가 있어요. 카페24, 가비아 같은 국내 호스팅은 관리자 페이지에 PHP 설정 메뉴를 따로 두는 경우가 많으니, 거기서 upload_max_filesize 값을 찾아 키워보세요. 메뉴 위치는 업체마다 달라서 정확한 경로는 각 호스팅 공식 안내에서 확인하는 게 안전해요.

메뉴가 없거나 못 찾겠으면 고객센터에 문의하면 돼요. 뭐라고 물어야 할지 몰라 미루게 되는데, 아래 문구를 그대로 복사해 쓰면 한 번에 전달돼요.

추가로 호스팅 디스크 용량이 꽉 차도 업로드가 실패해요. 관리자 페이지에서 남은 용량을 같이 확인하세요. 에러 로그를 받았다면 Claude Code에 붙여넣고 해석을 맡겨보세요. 영어투성이 로그도 ‘이 줄이 메모리 부족 기록이에요’처럼 원인 후보로 정리해줘서, 저 같은 비전공자에게는 이 방법이 제일 든든했어요.

7. 증상별 최종 체크리스트와 재발 방지 습관

오늘 확인한 내용을 점검 순서 그대로 정리했어요. 다음에 같은 오류가 떠도 위에서부터 하나씩 지워가면 대부분 중간에 해결 지점을 만나요.

마지막은 재발 방지예요. 저는 오류를 겪은 뒤 발행 루틴에 세 가지를 넣었고, 그 뒤로는 같은 오류를 만난 적이 없어요.

1. 업로드 전에 리사이즈·압축을 습관으로 — 오류 예방은 물론이고 페이지 로딩 속도와 SEO에도 도움이 돼요.
2. 파일명은 처음부터 영문 소문자와 하이픈으로 — final-screen-01.png 같은 규칙을 정해두면 나중에 파일 찾기도 쉬워요.
3. 새 플러그인을 설치하면 그날 바로 업로드 테스트 — 충돌을 설치 당일에 발견해야 범인 찾기가 쉬워요.

자주 묻는 질문

워드프레스 최대 업로드 파일 크기는 얼마인가요?

정해진 표준값은 없고 호스팅의 PHP 설정이 정해요. 관리자에서 미디어 > 파일 올리기에 들어가면 내 사이트의 한도가 표시돼요. 부족하면 php.ini나 호스팅 관리자 페이지에서 upload_max_filesize와 post_max_size를 키우면 돼요.

‘업로드한 파일을 이동할 수 없습니다’는 왜 나오나요?

uploads 폴더에 파일을 쓸 권한이 없어서예요. FTP로 접속해 wp-content/uploads 폴더 권한을 755로 맞추면 대부분 해결돼요. 777로는 올리지 마세요.

업로드는 됐는데 사진이 엑박으로 보여요.

파일은 올라갔는데 썸네일 생성이 실패했거나 캐시가 낡은 경우예요. 브라우저 캐시를 지우고, Regenerate Thumbnails 플러그인으로 썸네일 재생성을 돌리면 대부분 돌아와요.

php.ini 파일을 못 찾겠어요.

위치가 서버마다 달라요. 도구 > 사이트 건강 > 정보 탭의 서버 항목에서 경로를 볼 수 있어요. 공유 호스팅은 직접 접근이 막힌 경우도 많으니, 그때는 고객센터에 값 변경을 요청하는 게 가장 빨라요.

참고자료

• 워드프레스 공식 공통 오류 문서 — HTTP 오류 등 자주 발생하는 오류의 공식 해결 안내예요.
• 워드프레스 공식 사용자 문서 — 미디어 라이브러리 사용법과 기본 개념을 확인할 수 있어요.
• PHP 공식 ini 설정 문서 — upload_max_filesize, post_max_size, memory_limit의 공식 설명이에요.
• 워드프레스 공식 지원 포럼 — 같은 증상을 겪은 사례와 답변을 검색할 수 있어요.

처음 HTTP 오류를 만났을 때는 사이트를 통째로 날린 줄 알았는데, 지나고 보니 파일명 하나 바꾸는 일에서 시작되는 문제였어요. 오류 메시지를 읽고, 쉬운 것부터 지워가고, 막히면 Claude Code에 물어보는 이 순서만 있으면 비전공자도 충분히 스스로 해결할 수 있어요. 오늘 정리한 체크리스트를 북마크해 두셨다가, 다음에 업로드가 막히는 순간 위에서부터 하나씩 확인해 보세요. 저처럼 30분 안에 다시 글을 발행하고 계실 거예요.

함께 보면 좋은 글

• 워드프레스 플러그인 설치와 오류 해결 순서
• AI로 워드프레스 오류 해결하기, 코드 몰라도 따라 하는 진단 순서
• 워드프레스 사이트 속도 최적화, 초보자도 따라 하는 9단계 실습