워드프레스 대표 이미지는 멀쩡한데 본문 이미지만 깨질 때

먼저 결론
증상: 본문에 이미지 자리(figure 와 img 태그)는 있는데 그림이 안 보였고, 주소는 404 였습니다. 대표 이미지는 정상이었습니다.
원인: 이미지 교체 작업이 새 파일을 현재 달 폴더(uploads/2026/07/)에 넣었는데, 본문 img src 는 원래 달(2026/05, 2026/06)을 그대로 가리켰습니다.
해결: 파일은 건드리지 않고, 깨진 img src 의 달 폴더만 파일이 실제로 있는 곳으로 바꿨습니다.

1. 깨진 개수가 글마다 달랐다

2026년 7월 2일, 운영 중인 사이트의 글 몇 편에서 본문 이미지가 빈 자리로 보인다는 것을 알았습니다. 글을 열어 보면 그림이 들어갈 틀은 멀쩡히 있고, 그 안만 비어 있었습니다.

이상한 점은 두 가지였습니다. 하나는 깨진 개수가 글마다 6개, 5개, 1개, 2개처럼 제각각이었다는 것입니다. 다른 하나는 목록 화면에 뜨는 대표 이미지는 모두 정상이었다는 것입니다. 파일 전체가 사라졌다면 대표 이미지도 깨졌어야 합니다.

2. 그림 주소를 따라가 보니

깨진 그림의 주소를 열어 보니 404 였습니다. 주소의 모양은 /wp-content/uploads/2026/05/파일이름.jpg 처럼 5월이나 6월 폴더를 가리켰습니다.

서버에서 그 폴더를 보니 해당 파일이 없었습니다. 같은 파일 이름을 찾아보니 uploads/2026/07/ 에 있었습니다. 대표 이미지는 교체 뒤에는 이 07 폴더의 파일을 가리키고 있어서 멀쩡했던 것입니다.

위치 가리키는 경로 파일이 있나 화면
본문 img src 2026/05 또는 2026/06 없음 빈 자리, 404
대표 이미지 2026/07 있음 정상
실제 파일 2026/07 있음

3. 왜 달이 어긋났나

그 전에 이미지 교체 작업을 한 적이 있었습니다. 글에 들어간 그림 일부를 새 파일로 바꾸는 작업이었고, 새 파일은 wp media import 로 가져왔습니다.

워드프레스는 미디어 설정에서 "업로드한 파일을 월별, 연도별 폴더로 정리"가 켜져 있으면, 글에 붙이지 않고 가져온 파일을 올리는 그 달의 폴더에 넣습니다. wp media import 에 --post_id 를 주어 글에 붙이면 그 글을 쓴 달의 폴더로 가는 것이 일반 동작입니다. 당시 어떤 옵션으로 불렀는지는 확인하지 못했고, 결과로 7월에 가져온 파일은 07 폴더로 갔습니다. 대표 이미지는 새 첨부를 제대로 가리키게 됐지만, 본문 안의 img src 는 원래 글을 올린 달의 경로를 그대로 두었습니다. 파일 이름은 같고 달 폴더만 달랐던 것입니다.

깨진 개수가 글마다 달랐던 것도 이것으로 설명됩니다. 교체한 그림 수가 글마다 달랐기 때문입니다.

4. 파일은 두고 주소만 고쳤다

고치는 방법은 두 가지가 떠오릅니다. 파일을 옛 달 폴더로 복사하거나, 본문 주소를 새 달로 바꾸는 것입니다. 복사하면 같은 파일이 두 곳에 생기고, 미디어 라이브러리에 등록된 첨부와 따로 놀게 됩니다. 그래서 본문 주소의 달 폴더만 바꿨습니다. 정상인 이미지는 손대지 않았습니다.

순서는 진단, 백업, 적용입니다. 아래는 진단 방식을 보여 주는 예시입니다.

import os, re, sys
UP = "/var/www/example/wp-content/uploads"
html = sys.stdin.read()
for src in re.findall(r'<img[^>]+src="([^"]+)"', html):
    m = re.search(r"/uploads/(\d{4}/\d{2})/([^/?]+)", src)
    if not m:
        continue
    if not os.path.exists(os.path.join(UP, m.group(1), m.group(2))):
        alt = os.path.join(UP, "2026/07", m.group(2))
        print("MISSING", src, "->", "있음" if os.path.exists(alt) else "없음")

글 본문은 wp-cli 로 꺼내 넣고, 바꾸기 전 본문은 글 번호별 파일로 남깁니다. 고친 본문은 wp post update 에 - 를 줘 표준입력으로 넣습니다.

mkdir -p /tmp/img_backup
wp post get 123 --field=post_content > /tmp/img_backup/123.html
sed -E 's#/uploads/2026/0[56]/(파일이름\.jpg)#/uploads/2026/07/\1#' \
  /tmp/img_backup/123.html | wp post update 123 -

바꿀 때는 진단에서 "MISSING, 있음"으로 나온 파일 이름만 골라 바꿉니다. 달 폴더를 통째로 바꾸면 원래 그 달에 멀쩡히 있던 그림까지 깨집니다. 스크립트로 본문을 바꾸다 생기는 다른 사고는 wp-cli가 Success라는데 안 바뀌었을 때에도 적었습니다. sed 나 정규식으로 본문을 고치다 줄바꿈이 글자로 보이는 식의 사고는 워드프레스 본문을 스크립트로 고치다 글이 망가진 경우에 모았습니다.

5. 다시 훑어 0 을 확인했다

고친 뒤에는 세 가지로 확인했습니다.

  1. 같은 진단을 모든 글에 다시 돌려 MISSING 이 0 인지 봅니다
  2. 바꾼 그림 주소를 curl 로 불러 200 이 나오는지 봅니다
  3. 페이지 HTML 에 옛 05, 06 경로 참조가 0 개인지 봅니다

세 번째 확인에서 캐시가 옛 HTML 을 주면 고친 것이 안 보일 수 있습니다. 그때는 수정이 화면에 안 보일 때 캐시 확인법대로 캐시를 먼저 비웁니다.

지목된 글만 고치면 안 되는 이유

처음에 깨졌다고 알려진 것은 10편, 34자리였습니다. 그런데 같은 진단을 사이트 전체 글에 돌리니 3편, 7자리가 더 나왔습니다. 모두 합쳐 13편, 41자리를 고쳤고, 전체 재검사에서 MISSING 0 을 확인했습니다.

찾은 경로 글 이미지 자리
처음 지목된 글 10편 34
전체 스캔으로 더 찾은 글 3편 7
합계 13편 41

같은 교체 작업이 지나간 다른 글에도 같은 어긋남이 남아 있을 수 있습니다. 눈에 띈 글만 고치지 말고 같은 스캔을 작업이 지나간 곳 전체에 돌리는 것이 안전합니다.

이 글의 내용은 2026년 10월 22일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.