헤드리스 브라우저 전체 캡처에 사진이 비고 글이 두 번 찍힐 때

먼저 결론
증상: 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일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.