증상: playwright 로 찍은 전체 페이지 캡처에 사진 자리가 비어 있고, 글 끝에 머리와 본문이 한 번 더 붙어 나왔습니다. 오류 메시지는 없었습니다.
원인:
loading="lazy" 사진은 화면에 들어온 적이 없으면 받지 않고, 크롬은 한 장이 16,384 픽셀을 넘으면 그 뒤를 앞부분으로 채웁니다.해결: 600px 씩 0.25초 쉬며 끝까지 스크롤한 뒤 맨 위로 돌아와, 3,300 높이씩 clip 으로 나눠 찍습니다.
사람이 브라우저로 보면 멀쩡한 페이지가, 기계로 찍으면 이상하게 나올 때가 있습니다. 더 곤란한 것은 그 그림을 보고 "내가 화면을 깨뜨렸다"고 판단해 멀쩡한 코드를 고치게 된다는 점입니다. 실제로 그렇게 멀쩡한 코드를 고치다 시간을 버린 적이 있습니다.
그래서 이 글은 증상과 원인을 짝지은 표부터 놓습니다. 캡처가 이상하면 코드보다 이 표를 먼저 봅니다.
증상과 원인 짝표
| 본 것 | 실제 원인 | 오류가 나나 |
|---|---|---|
| 사진 자리가 빈 칸 | 지연 로딩 사진을 한 번도 화면에 안 들임 | 안 남 |
| 글 끝에 머리와 본문이 또 붙음 | 한 장이 16,384 픽셀을 넘어 앞부분으로 채움 | 안 남 |
| 구획 전체가 투명하게 사라짐 | 창이 숨어 있어 등장 애니메이션이 투명도 0 에 멈춤 | 안 남 |
인라인 opacity:1 인데 계산값 0 |
CSS transition 이 중간에 멈춤 | 안 남 |
| 가로 스크롤이 있다고 나옴 | 숨은 창의 뷰폭이 0 으로 잡힘 | 안 남 |
| "Screenshot timed out ... the page did not finish rendering" | 화면에 그려지지 않는 창으로 찍음 | 남 |
| 45초 시간 초과 | networkidle 을 기다렸는데 연결이 안 끝나는 사이트 |
남 |
사진이 빈 칸이고 글이 두 번 보였던 캡처
긴 글 하나를 전체 페이지로 찍었더니 사진 6장 자리가 모두 비어 있었고, 글 끝에 머리와 본문이 한 번 더 이어져 있었습니다. HTML 을 열어 보니 article 은 1개, 사진도 6장 모두 들어 있었습니다.
원인은 둘이었습니다. loading="lazy" 가 붙은 사진은 화면 안에 들어온 적이 있어야 받습니다. 스크롤 없이 바로 full_page 로 찍으면 아래쪽 사진은 한 번도 화면에 들어오지 않았으니 빈 칸입니다. 또 크롬은 한 장의 높이가 16,384 픽셀을 넘으면 그 뒤를 앞부분으로 채웁니다. 그래서 글이 두 번 있는 것처럼 보였습니다.
창이 숨으면 브라우저가 일을 멈춘다
다른 때에는 헤드리스가 아니라 화면에 띄운 브라우저를 자동으로 몰아 확인했습니다. 그 창이 뒤로 가 있거나 화면이 꺼지면 document.visibilityState 가 'hidden' 이 됩니다. 이때 브라우저는 성능을 아끼려고 requestAnimationFrame, CSS transition, 창 크기 계산을 멈춥니다.
그 결과 등장 애니메이션은 처음 상태인 투명도 0 에 얼고, 값은 중간에서 멈추고, 뷰폭은 0 으로 잡혔습니다. 찍으면 흰 화면이나 반쯤 투명한 그림이 나오고, 아예 "Screenshot timed out ... the page did not finish rendering" 으로 멈추기도 했습니다. 이 상태라면 코드 문제가 아닙니다.
값을 꼭 재야 하면 전환을 통째로 끄고 멈춘 조상을 손으로 푼 뒤 잽니다.
// 페이지 안에서 실행
const s = document.createElement('style')
s.textContent = '*{transition:none !important; animation:none !important}'
document.head.appendChild(s)
document.querySelectorAll('[style*="opacity"]').forEach(el => {
if (el.style.opacity === '0') { el.style.opacity = '1'; el.style.transform = 'none' }
})
결국 이렇게 찍는다
가장 확실한 길은 화면이 필요 없는 헤드리스 playwright 로 파일에 찍는 것이었습니다. 화면 상태와 상관없이 그려지기 때문입니다. 아래는 파이썬 판입니다.
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
b = p.chromium.launch()
ctx = b.new_context(viewport={"width": 1280, "height": 900}, reduced_motion="reduce")
page = ctx.new_page()
errors = []
page.on("console", lambda m: m.type == "error" and errors.append(m.text))
page.on("response", lambda r: r.status >= 400 and errors.append(f"{r.status} {r.url}"))
page.goto("https://example.com/post/", wait_until="domcontentloaded")
page.wait_for_timeout(3000)
h = page.evaluate("document.body.scrollHeight")
for y in range(0, h, 600): # 끝까지 내려가며 사진을 불러온다
page.evaluate(f"window.scrollTo(0, {y})")
page.wait_for_timeout(250)
page.evaluate("window.scrollTo(0, 0)")
h = page.evaluate("document.body.scrollHeight")
for i, top in enumerate(range(0, h, 3300)): # 3,300 높이씩 나눠 찍는다
page.screenshot(path=f"shot_{i}.png", full_page=True,
clip={"x": 0, "y": top, "width": 1280, "height": min(3300, h - top)})
print(errors)
b.close()
- 휴대폰 화면이면 새 컨텍스트에 폭 375 와
is_mobile=True, has_touch=True를 줍니다. reduced_motion="reduce"는 등장 연출을 건너뛰게 해 투명도 0 문제를 줄입니다.wait_until="networkidle"은 계측 스크립트나 소리 파일이 계속 오가는 사이트에서 45초 시간 초과가 났습니다.domcontentloaded뒤 몇 초 기다리는 편이 낫습니다.
같은 스크립트로 콘솔 오류와 400 이상 응답도 모았습니다. 이것으로 모든 페이지가 옛 통계 스크립트를 불러 404 를 내던 것을 찾았습니다. 화면만 보아서는 드러나지 않는 결함이었습니다.
이상할 때 먼저 볼 두 가지
첫째, 캡처가 이상하면 코드보다 캡처 방법을 먼저 의심합니다. 사진이 안 나오거나 글이 두 번 보이는 것은 대개 찍는 쪽 문제였습니다. 둘째, 자동으로 몬 브라우저 값이 이상하면 document.visibilityState 와 requestAnimationFrame 이 실제로 도는지부터 봅니다.
고친 화면이 안 바뀌어 보이는 다른 원인은 워드프레스 CSS 수정이 화면에 안 보일 때에 있고, 도구가 보여 준 숫자를 그대로 믿다 틀린 경우는 서버 로그로 상태를 판정하다 틀리는 실수에 모았습니다. 캡처 대신 curl 로 실제 서버의 HTML 을 받아 볼 때 밟기 쉬운 함정은 curl 로 라이브 반영을 확인할 때 저지른 세 가지 실수에 있습니다.
확인한 환경
| 항목 | 내용 |
|---|---|
| 캡처 도구 | 파이썬 playwright(헤드리스 크로미움) |
| 숨은 창 문제 | 자동으로 몬 브라우저 창, 2026년 8월 |
| 헤드리스로 바꾼 때 | 2026년 10월 5일 |
| 빈 사진과 두 번 찍힘 | 2026년 10월 13일, 사진 6장짜리 긴 글 |
이 글의 내용은 2026년 10월 21일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.