고친 내용이 라이브에 "반영 안 됨", 교체한 파일이 "없음", 사이트 인증서가 "만료"라고 판정했는데 셋 다 틀렸습니다. curl 에 -L 이 없어 301 의 빈 응답을 봤고, 주소를 손으로 퍼센트 인코딩하다 한 글자를 틀렸고, 만료된 것은 내 PC 파이썬의 인증서 묶음이었습니다. curl -sL 에 캐시 우회 파라미터를 붙여 받고 grep -c 로 세고, 주소는 코드로 만들고, 인증서 오류는 openssl s_client 로 실제 날짜를 봅니다.
무언가를 고친 뒤 "라이브에 들어갔나"를 확인하는 일은 하루에도 몇 번씩 합니다. 그래서 확인 방법이 틀리면 같은 실수가 하루에 여러 번 반복됩니다. 실제로 하루에 세 번 "반영 안 됨"이라고 잘못 판정한 적이 있습니다. 이런 판정은 멀쩡한 작업을 다시 하게 만듭니다.
지금 쓰는 확인 명령
먼저 결과부터 적습니다. 지금은 라이브 반영을 볼 때 이 두 줄로 시작합니다.
curl -sL -H 'User-Agent: Mozilla/5.0' "https://example.com/some-post/?cb=$RANDOM" -o /tmp/p.html -w '%{http_code}\n'
grep -c '확인할 문자열' /tmp/p.html
-L 은 리다이렉트를 끝까지 따라가게 하고, -w '%{http_code}' 는 마지막 응답 코드를 찍습니다. ?cb=$RANDOM 은 매번 다른 주소처럼 보이게 해 페이지 캐시를 피합니다. 마지막으로 받은 파일 안에서 바꾼 문자열이 몇 번 나오는지 셉니다.
캐시 여부를 따로 보고 싶으면 curl -I 로 x-cache, age 헤더를 봅니다. 다만 응답이 리다이렉트라면 그 헤더는 리다이렉트 응답의 것이라 믿을 수 없습니다.
실수 1: -L 없이 받은 빈 응답
워드프레스 글 주소는 301 로 다른 주소를 가리키는 경우가 많습니다. 끝의 슬래시가 빠졌거나 옛 주소로 요청했을 때가 그렇습니다. curl 은 -L 이 없으면 리다이렉트를 따라가지 않고 그 301 응답만 받습니다.
301 응답에는 본문이 거의 없습니다. 그 안에서 바꾼 문구를 찾으니 0이 나왔고, 그것을 "반영 안 됨"이라 보고했습니다. 응답 코드를 같이 찍었다면 200 이 아니라 301 이라는 것이 바로 보였을 것입니다.
실수 2: 근거 없이 캐시를 지목
두 번째 판정은 "캐시 탓"이었습니다. 반영이 안 보이면 캐시를 떠올리기 쉽지만, 이번에는 캐시가 아니라 여전히 리다이렉트 문제였습니다. 캐시라는 증거를 하나도 보지 않고 원인을 정한 것입니다.
지금은 서버에 저장된 값과 화면이 다르면 확인 방법을 먼저 의심하고, 그다음에 캐시를 의심합니다. 워드프레스 캐시 플러그인과 테마 CSS 캐시를 실제로 확인하고 비우는 법은 워드프레스 CSS 수정이 화면에 안 보일 때에 따로 적었습니다.
실수 3: 손으로 만든 주소의 404
교체했다는 이미지 파일을 확인하려고, 로그에 찍힌 한글 파일 이름을 손으로 퍼센트 인코딩해 열었습니다. 결과는 404 였습니다. "교체했다는데 파일이 없다"로 읽힐 판이었지만, 서버에서 ls 로 보니 파일은 멀쩡히 있었습니다.
틀린 것은 주소였습니다. U+AFC8 글자는 UTF-8 로 %EA%BF%88 인데 이것을 %EA%BD%88 로 한 글자 잘못 적었습니다. 사람 눈으로는 거의 구별되지 않는 차이입니다.
from urllib.parse import quote, urlsplit
u = "https://example.com/wp-content/uploads/한글_파일.png"
p = urlsplit(u)
print(f"{p.scheme}://{p.netloc}{quote(p.path)}")
검증 주소는 이렇게 코드로 만들고, 로그에 주소가 있으면 다시 타이핑하지 않고 그대로 복사합니다. 이미 인코딩된 주소를 또 인코딩하거나 대소문자가 달라지는 문제는 URL 검사가 전부 URL is unknown to Google 일 때에 있습니다.
확인용으로 보낸 curl 요청이 서버 로그 숫자를 부풀린 일은 서버 로그로 검색봇을 셀 때 내 요청이 섞이는 문제에 있습니다.
덧붙여: 만료된 것은 사이트가 아니었다
같은 검증에서 PC 의 파이썬 스크립트로 확인하다 이런 오류를 만났습니다.
CERTIFICATE_VERIFY_FAILED: certificate has expired
사이트 인증서가 죽은 줄 알았는데, 실제 인증서를 직접 보니 아직 유효했습니다. 만료된 것은 내 PC 파이썬이 쓰는 인증서 묶음(certifi 2025년 2월 판)이었습니다.
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates
SSL 만료 오류를 보면 사이트보다 내 쪽 인증서 저장소부터 의심합니다. 라이브 검증 자체는 저장소가 최신인 서버에서 돌리는 편이 낫습니다.
판정을 내리기 전 순서
| 본 것 | 먼저 확인할 것 | 그다음 |
|---|---|---|
| 바꾼 문구가 0번 | -w '%{http_code}' 가 200 인가, -L 을 붙였나 |
캐시 헤더, 캐시 비우기 |
| 파일 주소가 404 | 주소를 코드로 만들었나, 서버에서 ls |
업로드 경로와 권한 |
| 인증서 만료 오류 | openssl s_client 로 실제 날짜 |
내 PC 의 certifi 판 |
| 서버 값과 화면이 다름 | 확인 방법 자체 | 그다음에 캐시 |
이 글의 내용은 2026년 10월 11일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.