웹 개발 데일리 브리핑 — 2026-11-22
Soshy··조회수 —

기준 시점: 2026-11-22 06:00 KST
조사 범위: 전일 2026-11-21 06:00 ~ 당일 2026-11-22 06:00 KST
추천 글 범위: 기준 시점 당시 최근 7일
1️⃣ 프론트엔드
이번 조사 범위에서 포함할 만한 주요 신규 발표를 확인하지 못했습니다.
React, Next.js, Vercel, Vue, Nuxt, Angular, Svelte, SvelteKit, Astro, Remix의 공식 블로그와 GitHub 릴리스 기록을 조사했다.
이번 기간에는 새로운 주요 안정 버전이나 중요한 프론트엔드 API의 정식 출시를 확인하지 못했다.
다만 조사 범위에 해당하는 Next.js Canary 릴리스는 확인했다.
조사 과정에서 제외한 Next.js 16.5.0-canary.59
- 발표 시각: 2026-11-21 08:42 KST
- 버전: Next.js 16.5.0-canary.59
- 안정화 단계: Canary Pre-release
- 원문: https://github.com/vercel/next.js/releases/tag/v16.5.0-canary.59
Next.js가 새로운 Canary 버전을 공개했다.
GitHub의 공식 Release API에서 확인한 게시 시각은 다음과 같다.
2026-11-20T23:42:12Z
이를 한국 시간으로 변환하면 11월 21일 오전 8시 42분이다. 따라서 이번 조사 범위에 포함된다.
이번 릴리스의 주요 변경은 다음과 같다.
- Turbopack의 배포 디렉터리 Metadata를 Rust에서 생성하도록 변경
next/dynamic의 Loadable Manifest에서 Loader의 가용성을 Chunking 결과로 판단- Pages Router의
_app,_document관련 데이터 모듈에서?server-data유지 - 읽을 수 없는 Filesystem Cache 파일에 대한 오류 메시지 개선
- 기본 Process Import를 통한
NODE_ENV평가 오류 수정 - 사용하지 않는 Example과 문서 정리
이러한 변경은 실제 빌드 시스템의 정확성과 내부 유지보수에 관한 것이다.
예를 들어 Turbopack의 Cache 파일을 읽을 수 없는 경우 기존에는 문제가 발생한 원인을 명확하게 확인하기 어려울 수 있었다.
이번 수정은 해당 오류를 더 분명하게 표시하도록 한다.
또한 next/dynamic과 관련된 Manifest 생성 경로를 수정해 실제 Chunk 구성과 Loader의 관계를 일관되게 처리하도록 변경했다.
하지만 이번 릴리스에는 일반 사용자가 새롭게 사용할 수 있는 중요한 안정 API가 포함되지 않았다.
빌드 시간이나 메모리 사용량에 관한 정량적인 Benchmark도 공개되지 않았다.
따라서 중요한 신규 발표만 포함한다는 기준에 따라 본문 소식으로 선정하지 않았다.
Svelte 5.59.0은 조사 범위에서 제외
Svelte 5.59.0에서는 Custom Renderer API가 추가됐다.
이는 단순한 내부 수정이 아니라 새로운 활용 가능성을 가진 기능이다.
하지만 공식 GitHub Release API의 게시 시각은 다음과 같다.
2026-11-20T14:28:21Z
한국 시간으로는 11월 20일 오후 11시 28분이다.
이번 조사 범위가 시작되기 약 6시간 32분 전이므로 제외했다.
또한 뒤이어 공개된 Svelte 5.59.1의 게시 시각은 한국 시간 11월 21일 오전 4시 3분이다.
이 역시 오전 6시 컷오프 이전이다.
- Svelte 5.59.0 원문: https://github.com/sveltejs/svelte/releases/tag/svelte%405.59.0
- Svelte 5.59.1 원문: https://github.com/sveltejs/svelte/releases/tag/svelte%405.59.1
이처럼 날짜만 보면 이번 브리핑의 신규 소식처럼 보일 수 있는 릴리스라도 실제 게시 시각을 기준으로 제외했다.
그 밖에 Vue, Nuxt, Angular, SvelteKit, Astro, Remix의 공식 공개 기록에서도 이번 기간의 주요 안정 기능을 확인하지 못했다.
이전 브리핑에서 소개한 Vue 3.5.46의 SSR·Hydration 수정, SvelteKit 3.4.0의 Cloudflare Adapter 변경, Next.js 16.5 계열의 Turbopack 및 Cache 관련 변경은 반복하지 않았다.
2️⃣ 웹 플랫폼·브라우저
이번 조사 범위에서 포함할 만한 주요 신규 발표를 확인하지 못했습니다.
W3C, WHATWG, TC39, MDN, Chrome·Chromium, Firefox·Mozilla, WebKit·Safari의 주요 공식 자료와 JavaScript·TypeScript·CSS, 웹 성능 및 접근성 관련 발표를 조사했다.
이번 기간에는 새로운 주요 웹 표준의 정식 채택이나 안정 브라우저에서 기본 제공되기 시작한 중요한 신규 API를 확인하지 못했다.
WebKit에서는 11월 21일에도 개발 빌드가 생성됐다.
공식 Build Archive에는 다음과 같은 기록이 존재한다.
- 327512@main
- 327513@main
- 327514@main
하지만 이러한 기록은 WebKit 개발 브랜치의 빌드다.
개발 빌드가 생성됐다는 사실만으로 해당 날짜에 새로운 Safari 안정 버전이나 웹 플랫폼 기능이 출시됐다고 판단할 수 없다.
또한 CSS와 JavaScript 관련 규격의 초안 수정은 실제 브라우저 구현과 구분했다.
예를 들어 CSS 규격에 새로운 함수가 정의돼 있더라도 모든 안정 브라우저가 해당 함수를 지원하는 것은 아니다.
실제 프로덕션 코드에서는 브라우저 지원 범위와 Fallback을 별도로 고려해야 한다.
이번 추천 글에서는 이러한 차이와 관련해 CSS의 random() 함수를 심층 분석한 자료를 소개한다.
해당 글은 함수가 단순히 난수를 반환하는 데서 끝나지 않고, 요소와 CSS 속성, 호출 위치에 따라 난수 Seed를 공유하는 방식을 설명한다.
또한 실제 UI 개발에서 JavaScript와 Canvas를 사용하는 과정에서 발생한 문제를 다룬 구현 사례도 함께 선정했다.
3️⃣ 백엔드·인프라
이번 조사 범위에서 포함할 만한 주요 신규 발표를 확인하지 못했습니다.
Cloudflare, AWS, Google Cloud, Microsoft Azure의 공식 변경 기록과 서버리스·엣지 플랫폼, 데이터베이스·API 관련 공개 자료를 조사했다.
Cloudflare의 공식 Developer Changelog에서 확인한 최근 주요 신규 발표는 11월 20일에 집중돼 있었다.
대표적으로 다음 항목이 존재했다.
- Browser Run의 Custom Script API
- Workers·Pages의 과거 배포 버전 보관 정책 변경
- Cloudflare Images의 이미지 최적화 옵션 확대
- Workers VPC의 사용자 정의 CA 및 mTLS 지원
이러한 항목은 이전 브리핑에서 이미 다뤘으므로 반복하지 않았다.
- Cloudflare 공식 Changelog: https://developers.cloudflare.com/changelog/
Vercel의 공식 Changelog에서도 다음과 같은 최근 발표를 확인했다.
- Vercel Functions 요청 본문 최대 20MiB 지원
- Vercel Drives 파일 읽기 성능 개선
- Vercel Blob의 파일 TTL 지원
- 정적 사이트의 Instant Deployment 확대
하지만 모두 이번 조사 범위 이전에 공개된 항목이거나 이전 브리핑에서 이미 다뤘다.
- Vercel 공식 Changelog: https://vercel.com/changelog
AWS의 공식 What's New와 Google Cloud Release Notes, Azure의 주요 제품 발표도 확인했다.
- AWS 공식 발표: https://aws.amazon.com/about-aws/whats-new/
- Google Cloud 공식 Release Notes: https://docs.cloud.google.com/release-notes/
- Azure 공식 업데이트: https://azure.microsoft.com/en-us/updates/
이번 기간에 처음 발표됐다는 사실과 실제 변경 내용, 안정화 단계를 함께 확인할 수 있는 중요한 신규 기능은 선정하지 못했다.
특히 미국 현지 날짜로 11월 20일에 발표된 항목은 실제 게시 시각이 한국 시간 11월 21일 오전 6시 이후라는 근거가 없는 한 이번 기간에 포함하지 않았다.
또한 기존 기능을 소개하는 기술 블로그나 여러 이전 발표를 모은 주간 요약을 새로운 제품 출시로 취급하지 않았다.
4️⃣ 개발 도구 및 보안
이번 조사 범위에서 포함할 만한 주요 신규 발표를 확인하지 못했습니다.
Node.js, Deno, Bun, Vite, webpack, Rollup, esbuild, Babel, Biome, ESLint, Prettier, npm, pnpm, Yarn, GitHub, GitLab 및 주요 테스트·배포 도구의 공식 릴리스 기록을 조사했다.
GitHub의 공식 Changelog에서 확인한 최근 주요 발표는 11월 20일까지였다.
대표적으로 다음과 같다.
- Security Advisory 권한의 Generally Available 전환
- GitHub Enterprise Server 3.23 Release Candidate
- Dashboard의 즐겨 사용하는 Repository 고정 기능
이번 조사 기간에 해당하는 중요한 신규 발표는 확인하지 못했다.
- GitHub 공식 Changelog: https://github.blog/changelog/
- GitHub 2026년 11월 기록: https://github.blog/changelog/month/11-2026/
또한 최근 공개된 다음 릴리스는 날짜와 실제 변경 범위를 확인한 뒤 이번 기간의 신규 항목에서 제외했다.
- Svelte 5.59.0 및 5.59.1
- Vue 3.5.46
- SvelteKit 3.4.0
- Biome 2.6.8
- Vite 8.3.8
- Node.js의 11월 보안 릴리스
보안 분야에서는 OWASP와 주요 공급망 보안 자료 및 기존 CVE의 변경 기록을 확인했다.
하지만 이번 기간에 처음 공개된 중요한 취약점과 영향 버전, 실제 수정 버전을 공식 원문으로 함께 확인할 수 있는 신규 항목은 선정하지 못했다.
취약점 데이터베이스의 수정 날짜나 재분석 날짜만으로 새로운 취약점이 최초 공개됐다고 판단하지 않았다.
특히 기존에 다룬 다음 보안 항목을 반복하지 않았다.
- NGINX HTTP/2의 CVE-2026-123007
- Java4Shell 관련 보안 수정 및 WAF 대응
- Next.js의 Binary Cache Key 관련 보안 수정
- Google Cloud의 Java Runtime 수정 버전
- GitHub AI Scan의 Repository 검토 기능
이번 기간에는 주요 도구와 보안 플랫폼에서 검증된 신규 발표가 적었다. 따라서 이전 소식을 반복하거나 개발 브랜치의 변경을 과장하지 않고, 최근 7일간 공개된 구체적인 구현·설계·운영 경험을 추천 글에 집중해 정리했다.
📚 추천 글
Understanding CSS random() — CSS 난수의 범위보다 중요한 Seed 공유와 Scope 규칙
- 저자: Mat Marquis
- 매체: Piccalilli
- 게시일: 2026-11-18
- 기술: CSS random(), Custom Properties, Media Query, CSS Animation, View Timeline
- 원문: https://piccalil.li/blog/understanding-css-random/
CSS의 random() 함수를 실제 개인 블로그의 UI에 적용하면서 난수가 어떻게 생성되고, 같은 요소에서 언제 다시 사용되며, 어떤 설정에서 여러 요소가 같은 난수를 공유하는지 설명한 기술 글이다.
단순히 새로운 CSS 함수를 소개하는 자료가 아니다.
작성자는 자신의 블로그에 손으로 작성한 메모처럼 보이는 작은 사이드 노트를 추가했다.
처음에는 각 메모에 같은 회전값을 적용했다.
하지만 모든 메모가 정확히 같은 각도로 회전하니 실제 손글씨처럼 자연스럽게 보이지 않았다.
따라서 각 메모에 조금씩 다른 회전값을 주려고 했다.
이 과정에서 CSS random()을 사용했다.
기본 random() 문법
CSS의 random()은 최소값과 최대값을 전달받는다.
대표적인 표현은 다음과 같다.
random(0px, 10px)
이는 0px에서 10px 사이의 값을 생성한다.
세 번째 인자를 사용하면 간격을 지정할 수 있다.
random(0px, 10px, 5px)
이 경우 가능한 결과는 다음과 같다.
- 0px
- 5px
- 10px
작성자는 사이드 노트에 다음 표현을 적용했다.
rotate(random(-2.5deg, 2.5deg))
따라서 각 메모는 -2.5도에서 +2.5도 사이의 각도로 회전한다.
실제로 매우 작은 각도지만 모든 메모가 정확하게 정렬된 것보다 자연스러운 표현을 만들 수 있었다.
단순한 Math.random()과 다른 점
이번 글에서 중요한 부분은 CSS random()이 값을 생성하는 방식이다.
JavaScript의 Math.random()을 호출하면 일반적으로 매번 새로운 난수 값을 얻는다.
하지만 CSS random()에서는 같은 Scope에 속하는 호출이 같은 Seed를 공유할 수 있다.
기본적인 Scope는 다음 세 요소에 의해 결정된다.
- DOM 요소
- CSS Property
- 해당 Property에서 random()이 등장한 순서
예를 들어 다음 두 요소가 있다고 가정해 보자.
<div class="note"></div>
<div class="note"></div>
두 요소에 같은 CSS를 적용한다.
transform: rotate(random(-2.5deg, 2.5deg))
각 요소는 서로 다른 난수 Seed를 가질 수 있다.
따라서 서로 다른 회전값을 얻는다.
하지만 같은 요소의 같은 Property에 같은 위치로 등장하는 random() 호출은 Seed를 공유할 수 있다.
따라서 단순히 Media Query가 변경됐다는 사실만으로 해당 요소의 회전값이 다시 생성되는 것은 아니다.
Media Query에서의 안정성
작성자는 화면 너비에 따라 메모의 크기를 변경했다.
작은 화면에서는 다음 Scale을 사용했다.
scale(0.925)
넓은 화면에서는 다음 값을 사용했다.
scale(1)
하지만 transform을 새로운 값으로 덮어쓰면 기존 rotate()가 사라진다.
따라서 Media Query에도 rotate(random(...))을 다시 작성했다.
여기서 흥미로운 결과가 나타났다.
같은 요소의 같은 Transform Property에서 동일한 호출 위치를 유지하면 Media Query가 변경돼도 이전 회전값이 유지됐다.
즉 사용자가 브라우저 창을 확대하거나 축소할 때 메모의 회전값이 매번 바뀌지 않는다.
이러한 특성은 시각적인 일관성을 유지하는 데 도움이 된다.
CSS Animation에서도 같은 Seed 사용
작성자는 View Timeline 기반의 Animation도 사용했다.
메모가 화면 안으로 들어오면 크기와 Opacity가 변경된다.
하지만 Keyframes의 transform에서도 회전값을 유지해야 했다.
따라서 각 Keyframe에 동일한 random() 호출을 포함했다.
이 경우에도 같은 Scope의 Seed가 재사용될 수 있다.
따라서 실제 Animation 중 Scale은 변경되지만 회전 각도는 유지된다.
이러한 구조는 CSS Animation과 무작위 스타일을 함께 사용할 때 중요하다.
property-scoped
기본 Scope가 항상 적절한 것은 아니다.
예를 들어 다음 표현을 생각해 보자.
margin-block: random(1rem, 5rem) random(1rem, 5rem)
하나의 Property 안에 random()이 두 번 등장한다.
기본 Scope에서는 호출 위치가 다르므로 서로 다른 값을 얻을 수 있다.
하지만 위쪽과 아래쪽 Margin에 같은 값을 사용하고 싶을 수 있다.
이 경우 다음 설정을 사용할 수 있다.
property-scoped
이 옵션은 난수 Seed의 Scope를 Property 수준으로 확장한다.
다만 주의할 점이 있다.
Property 수준으로 Scope를 확장하면 개별 요소마다 다른 값을 유지하던 성질도 달라질 수 있다.
따라서 같은 Property를 사용하는 여러 요소가 하나의 Seed를 공유할 수 있다.
작성자는 이러한 동작이 실제 의도와 일치하는지 확인해야 한다고 설명한다.
element-scoped
반대로 하나의 요소에서 서로 다른 Property가 같은 난수 Seed를 사용하도록 할 수도 있다.
대표적인 옵션은 다음과 같다.
element-scoped
예를 들어 같은 요소에서 다음 값을 연관시키고 싶다고 가정해 보자.
- Margin
- Padding
- Border Width
이 경우 element-scoped를 사용하면 해당 요소에 속한 여러 Property가 같은 Seed를 공유하도록 구성할 수 있다.
하지만 다른 요소는 별도의 Seed를 가질 수 있다.
따라서 전체 페이지의 요소마다 서로 다른 값이 필요하지만, 하나의 요소 안에서는 일관된 값이 필요한 경우에 활용할 수 있다.
명시적인 난수 Key
작성자는 다음과 같이 이름을 붙인 Key도 설명한다.
--random-rotation
이 Key는 CSS Custom Property와 모양이 비슷하다.
하지만 실제 역할은 다르다.
명시적인 난수 Key는 어떤 random() 호출이 같은 Seed를 사용할지 지정하는 데 사용한다.
반면 다음 코드를 생각해 보자.
:root { --random-margin: random(0px, 10px); }
이후 여러 요소에서 var(--random-margin)을 사용한다.
이 Custom Property는 이미 계산된 하나의 난수값을 저장하는 것이 아니다.
실제로는 random() 표현식을 전달한다.
따라서 사용하는 위치의 Scope에 따라 다른 결과가 발생할 수 있다.
이는 JavaScript에서 미리 계산한 난수값을 변수에 저장하는 것과 다른 동작이다.
fixed를 이용한 디버깅
작성자는 다음 옵션도 소개한다.
fixed
예를 들어 다음 표현이다.
random(fixed 0.5, -2.5deg, 2.5deg)
이 경우 결과는 0도다.
0에서 1 사이의 고정된 Seed를 사용하기 때문이다.
이러한 방식은 실제 난수 범위를 조정할 때 유용하다.
예를 들어 디자인이 다음 값에서 자연스럽게 보이는지 확인할 수 있다.
- 최소값
- 중간값
- 최대값
하지만 fixed는 실제 난수의 자연스러운 분포를 생성하는 기능이 아니다.
주로 결과를 예측할 수 있는 상태에서 스타일을 테스트하는 데 적합하다.
브라우저 지원과 실제 적용의 한계
이번 기능은 비교적 새로운 CSS 기능이다.
따라서 모든 안정 브라우저에서 같은 방식으로 지원된다고 가정해서는 안 된다.
실제 프로덕션에 적용하려면 다음 사항을 확인해야 한다.
- 대상 브라우저의 지원 여부
- 지원하지 않는 경우의 Fallback
- Media Query에서의 Transform 재정의
- Animation에서의 Seed 공유
- 시각적 변화가 사용자 경험에 미치는 영향
또한 이 글은 실제 UI에 적용하면서 발견한 동작을 분석한 자료다.
JavaScript 방식과 CSS 방식을 비교한 CPU 및 렌더링 성능 Benchmark는 포함되지 않았다.
이번 글은 CSS의 새로운 함수를 단순한 값 생성 API로 이해하는 것이 아니라 실제 렌더링 Scope와 계산 결과의 재사용 규칙까지 이해해야 한다는 점을 구체적인 UI 구현으로 설명한다.
Building a transit map editor in the browser — 45도 경로와 둥근 모서리, 병렬 노선을 자동 생성하는 SVG 설계
- 저자: transitmapper
- 매체: DEV Community
- 게시일: 2026-11-20
- 기술: React, JavaScript, SVG, 기하 알고리즘, 브라우저 기반 편집기
- 원문: https://dev.to/transitmapper/building-a-transit-map-editor-in-the-browser-45deg-routing-rounded-corners-and-parallel-line-2c1
브라우저에서 대중교통 노선도를 제작하는 편집기를 만들면서 사용자가 모든 선을 직접 그리는 방식 대신 정류장과 노선 데이터를 입력하면 SVG 경로를 자동으로 계산하도록 설계한 과정을 설명한 글이다.
작성자는 오랫동안 Microsoft Publisher를 이용해 대중교통 노선도를 만들었다.
하지만 Publisher의 지원이 종료되면서 기존 작업을 대신할 도구가 필요해졌다.
새로운 도구는 Liniennetz-Editor다.
React를 이용해 편집 UI를 구현했다.
실제 노선도의 경로 계산은 별도의 기하 알고리즘으로 처리한다.
또한 서버 없이 브라우저에서 실행되도록 구성했다.
선을 그리는 대신 네트워크를 설명
일반적인 그래픽 편집기에서는 사용자가 선분을 직접 배치한다.
예를 들어 다음과 같은 노선도가 있다고 가정해 보자.
- 정류장 300개
- 노선 50개
- 여러 노선이 같은 구간을 공유
모든 구간의 선분을 직접 그리면 수정이 어려울 수 있다.
특히 정류장 하나를 이동했을 때 연결된 여러 노선의 선분을 다시 배치해야 할 수 있다.
작성자는 다른 방식을 선택했다.
사용자는 다음 정보를 입력한다.
- 정류장
- 노선
- 노선의 정류장 순서
- 정류장 유형
- 정류장의 Grid 위치
이후 편집기가 실제 연결선을 계산한다.
따라서 사용자는 네트워크의 구조를 수정하고 기하 알고리즘이 실제 SVG를 생성하도록 한다.
45도·90도 경로
대중교통 노선도에서는 일반적인 지도와 다른 표현을 사용할 수 있다.
실제 철도와 도로의 모양을 그대로 그리지 않고 다음 각도의 선을 사용하는 것이다.
- 수평
- 수직
- 45도 대각선
이러한 표현은 노선의 구조를 단순화하는 데 도움이 된다.
예를 들어 두 정류장이 다음 위치에 있다고 가정해 보자.
- A: (0, 0)
- B: (120, 60)
작성자는 두 정류장 사이의 가로·세로 거리 가운데 작은 값을 이용해 대각선 구간의 길이를 결정한다.
이 경우 60만큼 대각선으로 이동할 수 있다.
나머지 가로 거리 60은 수평 구간으로 표현할 수 있다.
따라서 전체 연결을 수평·수직·45도 선분으로 구성한다.
하지만 실제 경로는 정류장의 위치와 주변 노선에 따라 달라질 수 있다.
이 방식은 실제 지리적 경로를 정확하게 재현하는 알고리즘이 아니라 노선도에 적합한 기하학적 표현이다.
둥근 모서리
선분이 만나는 부분에는 둥근 모서리를 적용한다.
예를 들어 다음 경로를 생각해 보자.
- 수평 이동
- 45도 회전
- 대각선 이동
두 선분이 직접 만나면 날카로운 모서리가 생긴다.
작성자는 이를 SVG의 곡선 또는 Arc로 표현하도록 했다.
하지만 모서리 반지름을 무조건 크게 적용하면 문제가 발생할 수 있다.
예를 들어 두 선분 가운데 하나가 매우 짧다고 가정해 보자.
큰 반지름을 적용하면 실제 곡선이 인접한 다른 구간과 겹칠 수 있다.
따라서 작성자는 다음 값을 고려한다.
- 두 선분의 길이
- 실제 회전 각도
- 원하는 반지름
곡선의 접선 길이는 회전 각도에 따라 계산한다.
또한 두 선분 길이의 절반을 넘지 않도록 제한한다.
대표적인 계산 관계는 다음과 같다.
min(r × tan(θ / 2), l1 / 2, l2 / 2)
여기서 다음과 같이 해석할 수 있다.
- r: 원하는 곡선 반지름
- θ: 회전 각도
- l1: 첫 번째 선분 길이
- l2: 두 번째 선분 길이
이렇게 하면 매우 짧은 선분에서 곡선이 지나치게 커지는 문제를 줄일 수 있다.
병렬 노선 Bundling
이번 글에서 가장 복잡한 부분은 여러 노선이 같은 구간을 공유하는 경우다.
예를 들어 하나의 철도 구간에 다음 세 노선이 지나간다고 가정해 보자.
- 빨간색 노선
- 파란색 노선
- 초록색 노선
세 노선을 정확히 같은 SVG 경로에 그리면 서로 겹친다.
따라서 실제로 사용자는 가장 위에 그린 노선만 볼 수 있다.
이를 해결하기 위해 각 노선을 조금씩 옆으로 이동시켜야 한다.
작성자는 같은 선분을 공유하는 노선을 그룹으로 묶는다.
그리고 각 노선에 Lane Index를 부여한다.
대표적인 Offset 계산은 다음과 같다.
(index - (count - 1) / 2) × gap
예를 들어 세 노선이 존재한다고 가정해 보자.
Index는 다음과 같다.
- 0
- 1
- 2
전체 Lane 수는 3이다.
따라서 각각 다음 Offset을 가진다.
- -gap
- 0
- +gap
이렇게 하면 세 노선이 중앙을 기준으로 대칭적으로 배치된다.
공유 구간에서의 노선 순서
하지만 Offset만 적용하면 충분하지 않다.
예를 들어 두 정류장 사이에서는 빨간색 노선이 위쪽에 존재한다.
다음 정류장 이후에는 같은 노선이 아래쪽으로 이동할 수 있다.
이러한 상황에서는 노선이 서로 교차하는 것처럼 보일 수 있다.
작성자는 실제 공유 구간에서 Lane 순서를 일관되게 유지하도록 처리했다.
따라서 하나의 연속된 구간에서 같은 노선이 갑자기 다른 위치로 이동하는 문제를 줄였다.
하지만 여러 노선이 합류하거나 분기하는 지점에서는 여전히 복잡한 경로 계산이 필요하다.
병렬 경로의 모서리
하나의 중심 경로에 단순한 Offset을 적용하면 둥근 모서리에서도 문제가 발생한다.
예를 들어 왼쪽 Lane과 오른쪽 Lane은 회전할 때 실제 이동 거리가 다를 수 있다.
따라서 모든 Lane에 같은 곡선 반지름을 적용하면 선 사이의 간격이 일정하지 않을 수 있다.
작성자는 각 Lane의 실제 위치를 고려해 교차점과 곡선 반지름을 계산하도록 했다.
이렇게 하면 병렬 노선의 모서리에서도 일정한 간격을 유지할 수 있다.
하지만 모든 복잡한 교차로에서 완벽한 시각적 결과를 보장하지는 않는다.
데이터와 SVG 생성의 분리
이번 구현의 중요한 설계는 실제 SVG 경로를 계산하는 코드를 React 컴포넌트와 분리했다는 점이다.
React는 다음 작업을 담당한다.
- 정류장 선택
- Drag
- 노선 편집
- Undo·Redo
- 실제 화면 표시
반면 기하 알고리즘은 다음 작업을 수행한다.
- 정류장 사이의 연결 계산
- 각도 조정
- 곡선 생성
- 병렬 Lane 배치
- SVG 경로 문자열 생성
따라서 같은 입력 데이터에 대해 동일한 SVG를 생성할 수 있다.
또한 UI를 변경하더라도 기하 알고리즘 자체를 다시 작성할 필요가 줄어든다.
Undo·Redo
작성자는 편집 상태를 복제해 이전 상태를 보관하는 방식을 사용했다.
예를 들어 사용자가 정류장을 이동했다고 가정해 보자.
이전 상태를 History에 저장한다.
이후 새로운 좌표를 적용한다.
사용자가 Undo를 누르면 이전 상태를 복원한다.
이러한 방식은 구현이 비교적 단순하다.
하지만 실제 네트워크 데이터가 매우 크다면 매번 전체 상태를 복제하는 비용이 증가할 수 있다.
따라서 프로젝트 규모가 커지면 Patch 기반 History나 부분적인 상태 저장을 검토할 수도 있다.
성능과 한계
작성자는 약 300개 정류장과 50개 노선을 포함한 규모를 고려했다.
또한 실제 변경되지 않은 Geometry를 다시 계산하지 않도록 Cache를 적용했다.
예를 들어 사용자가 한 정류장을 Drag한다고 가정해 보자.
실제로 변경된 경로만 다시 계산하면 전체 노선도의 계산량을 줄일 수 있다.
하지만 이번 글에는 다음 수치가 포함되지 않았다.
- SVG 생성 시간
- Drag 중 Frame Rate
- 캐시 적용 전후 계산 시간
- 대규모 노선도에서의 메모리 사용량
또한 일부 복잡한 분기점에서는 Lane을 다시 중앙 정렬하는 과정에서 눈에 띄는 꺾임이 발생할 수 있다고 설명한다.
실제 Geometry에 관한 자동 테스트도 충분히 마련된 상태는 아니다.
따라서 이번 결과를 모든 노선도에 적용할 수 있는 완성된 Routing Engine으로 일반화할 수 없다.
이번 글은 복잡한 SVG 시각화를 구현할 때 사용자의 직접적인 Drawing 작업을 줄이고, 데이터 구조와 기하 알고리즘 및 UI 상태를 분리하는 방법을 구체적인 설계 선택과 함께 보여준다.
My directory sells ads. Here's the lint rule and the tests that keep them out of the ranking — 유료 광고가 검색 순위에 영향을 주지 못하도록 아키텍처를 검사하는 방법
- 저자: Kunal
- 매체: AppFinder / DEV Community
- 게시일: 2026-11-20
- 기술: Next.js, TypeScript, ESLint, Vitest, Drizzle ORM, PostgreSQL, 아키텍처 테스트
- 원문: https://dev.to/appfinder/my-directory-sells-ads-heres-the-lint-rule-and-the-tests-that-keep-them-out-of-the-ranking-3jcl
소프트웨어 디렉터리 서비스를 운영하면서 유료 광고와 일반 검색 순위가 서로 영향을 주지 못하도록 코드 구조 자체에 검증 규칙을 추가한 사례다.
AppFinder는 소프트웨어를 검색하고 비교하는 서비스다.
서비스는 광고와 유료 프로모션으로 수익을 얻는다.
하지만 일반 검색 결과의 순위는 광고비에 영향을 받지 않는다는 정책을 가지고 있다.
문제는 실제 코드베이스가 커질수록 이러한 정책을 개발자의 주의에만 의존하기 어려워진다는 점이다.
작성자는 이를 해결하기 위해 세 가지 검증 계층을 만들었다.
실제 검색 순위의 계산
AppFinder의 일반 검색 순위는 다음 요소를 사용한다.
| 평가 요소 | 가중치 |
|---|---|
| 커뮤니티 추천 | 40% |
| 사용자 평점 | 30% |
| 추천에 대한 피드백 | 10% |
| 등록 정보의 완성도 | 15% |
| 정보의 최신성 | 5% |
여기에는 광고비나 유료 플랜의 가격이 포함되지 않는다.
예를 들어 다음 두 앱이 있다고 가정해 보자.
- App A: 사용자 평점이 높은 무료 등록 앱
- App B: 광고비를 지불한 유료 등록 앱
App B가 광고비를 더 많이 지불했다는 이유만으로 일반 검색 순위가 상승해서는 안 된다.
하지만 실제 코드에서 결제 관련 데이터를 검색 점수 계산 함수에 전달하면 이러한 정책이 깨질 수 있다.
첫 번째 계층: ESLint Import 제한
작성자는 일반 검색 순위와 추천 로직이 존재하는 디렉터리를 지정했다.
대상은 약 26개 디렉터리다.
예를 들어 다음 영역이다.
- Scoring
- Search
- Recommendation
- AI Advisor
- MCP Tool
- Crawler
- Vote 처리
이후 해당 영역에서 유료 프로모션 관련 모듈을 Import하지 못하도록 ESLint를 설정했다.
사용한 규칙은 다음과 같다.
no-restricted-imports
금지한 영역은 다음과 같다.
- Billing
- Bidding
- Sponsorship
- Placement
- Wallet
- Entitlement
예를 들어 다음 Import가 존재한다고 가정해 보자.
@/server/billing/checkout
일반 검색 순위 코드에서 해당 모듈을 Import하면 ESLint 오류가 발생한다.
따라서 개발자가 코드를 작성하는 시점에 아키텍처의 경계를 확인할 수 있다.
Import 제한의 한계
하지만 첫 번째 계층만으로는 충분하지 않았다.
예를 들어 다음과 같은 상대 경로 Import가 존재할 수 있다.
../billing/checkout
기존 ESLint 규칙이 @/server/billing/* 형태만 검사한다면 해당 Import를 놓칠 수 있다.
또한 모든 데이터베이스 Table이 같은 Schema Module에서 Export되고 있었다.
따라서 일반 검색 코드가 공통 Schema를 Import하는 것은 정상적인 작업이었다.
하지만 같은 Schema에서 결제 관련 Table까지 Import할 수 있었다.
또한 Raw SQL을 사용하면 실제 Import 없이 결제 Table을 조회할 수도 있다.
따라서 단순한 Import 문자열 검사만으로는 모든 경계를 지킬 수 없었다.
두 번째 계층: 아키텍처 테스트
작성자는 별도의 Vitest 테스트를 만들었다.
대표적인 파일은 다음과 같다.
tests/architecture.test.ts
이 테스트는 실제 소스코드를 읽는다.
그리고 다음 작업을 수행한다.
- 주석과 문자열을 구분하며 코드 분석
- Static Import 수집
- Dynamic Import 수집
- require 호출 수집
- 실제 Module 경로 해석
- 금지된 모듈 및 데이터베이스 Table 사용 검사
특히 Alias와 상대 경로를 실제 Repository 경로로 변환한다.
따라서 Import 문자열의 모양이 달라도 실제 같은 모듈을 가리킨다면 탐지할 수 있다.
Drizzle Schema에서 실제 Table 이름 추출
작성자는 금지된 Table 목록을 모두 수작업으로 작성하지 않았다.
대신 Drizzle ORM의 Schema에서 실제 Table을 읽는다.
대표적으로 다음 API를 사용한다.
- getTableName()
- is()
- PgTable
이후 실제 Table 이름이 특정 Pattern에 해당하는지 검사한다.
예를 들어 다음 이름이다.
- category_bids
- orders
- sponsorship_*
- wallet_*
- analytics_*
이렇게 하면 새로운 Sponsorship Table이 추가됐을 때도 해당 이름의 Pattern이 일치하면 자동으로 검사 대상이 된다.
따라서 개발자가 새로운 Table을 추가할 때마다 테스트 목록을 수동으로 변경해야 하는 부담을 줄인다.
하지만 실제 Table 이름이 기존 Pattern과 다르면 탐지하지 못할 수 있다.
따라서 Naming Convention도 중요한 아키텍처 계약이 된다.
유료 계정의 필드 사용 금지
작성자는 검색 순위 계산에 사용하면 안 되는 필드도 명시했다.
대표적으로 다음과 같다.
- verified_at
- custom_cta_url
- long_description
이러한 필드는 유료 또는 검증된 계정에서만 사용할 수 있는 정보일 수 있다.
예를 들어 유료 앱은 더 긴 설명을 작성할 수 있다고 가정해 보자.
하지만 실제 일반 검색 순위의 점수가 단순히 설명의 길이에 영향을 받는다면 유료 계정이 간접적으로 이익을 얻을 수 있다.
따라서 작성자는 이러한 필드를 점수 계산에서 직접 사용하지 못하도록 했다.
이는 단순히 결제 모듈을 Import하지 않는 것보다 더 구체적인 정책이다.
검사기 자체의 테스트
이번 글에서 중요한 부분은 실제 검증 도구도 테스트해야 한다는 점이다.
작성자는 아키텍처 테스트가 정상적으로 실행되는지 별도 Fixture로 확인했다.
예를 들어 다음 코드를 Fixture에 포함한다.
- 금지된 Billing Module Import
- Dynamic Import
- 상대 경로를 통한 Sponsorship Module 참조
- Raw SQL의 Wallet Table 접근
- 중첩된 Template Literal
그리고 해당 코드가 실제로 탐지되는지 확인한다.
반면 주석에 금지된 Table 이름이 포함돼 있는 경우에는 오류로 판단하지 않아야 한다.
이렇게 하면 검사기가 아무것도 발견하지 못한 채 항상 통과하는 상황을 줄일 수 있다.
세 번째 계층: 실제 돈을 지불해 보는 테스트
하지만 정적 분석만으로는 모든 문제를 확인할 수 없다.
예를 들어 일반 검색 점수 계산 함수는 결제 모듈을 직접 Import하지 않는다.
그러나 다른 함수에서 유료 여부를 계산해 인자로 전달할 수 있다.
이 경우 금지된 Import가 존재하지 않더라도 검색 점수가 유료 정보에 영향을 받을 수 있다.
저자는 이러한 문제를 확인하기 위해 실제 PostgreSQL 통합 테스트를 작성했다.
테스트에서는 다음 작업을 수행한다.
- 테스트용 데이터베이스 생성
- 특정 카테고리에서 순위가 가장 낮은 앱 선택
- 일반 검색 결과와 점수 저장
- 해당 앱에 유료 혜택 부여
- 일반 검색 결과와 점수 재계산
- 이전 결과와 비교
부여하는 유료 혜택은 다음과 같다.
- Verified Owner
- Pro Plan
- 큰 광고 Bid
- Sponsored Booking
- 풍부한 Media
- 증가한 Traffic
이후 실제 일반 검색 순위가 변경되는지 확인한다.
점수 비교의 오차 허용
작성자는 실제 점수를 소수점 세 자리까지 비교했다.
이유는 Freshness 계산에 시간에 따른 작은 차이가 발생할 수 있기 때문이다.
예를 들어 두 번의 검색 점수 계산 사이에 몇 밀리초가 지났다고 가정해 보자.
최신성 점수를 실제 시간으로 계산한다면 아주 작은 차이가 발생할 수 있다.
따라서 이러한 차이를 허용하면서 유료 혜택에 따른 의미 있는 점수 변경을 탐지하도록 했다.
또한 다음 결과도 비교한다.
- Category Ranking
- Search Results
- Best-of Page
- Recommendation
- Homepage Section
- Related Comparison
따라서 단일 점수 함수가 아니라 실제 여러 사용자 화면의 순위를 검증할 수 있다.
실제 검증 비용
이번 구조에는 비용도 존재한다.
첫 번째는 오탐이다.
예를 들어 일반 검색 코드에 orders라는 이름의 지역 변수가 존재한다고 가정해 보자.
아키텍처 검사가 이를 금지된 Table 참조로 판단할 수 있다.
작성자는 이러한 경우 변수 이름을 변경하도록 한다.
두 번째는 관리 비용이다.
새로운 순위 계산 디렉터리를 추가하면 ESLint와 아키텍처 테스트의 대상에 포함해야 한다.
세 번째는 테스트 데이터베이스의 실행 비용이다.
실제 PostgreSQL을 사용하는 통합 테스트는 단순한 문자열 검사보다 실행 비용이 크다.
실제 보장의 범위
이번 글에서 중요한 한계는 다음과 같다.
광고비가 일반 검색 점수에 영향을 주지 않는다는 사실과 검색 순위 자체가 좋은 품질이라는 사실은 서로 다르다.
예를 들어 사용자의 평점이 잘못 집계될 수 있다.
또는 특정 종류의 앱이 구조적으로 유리한 점수를 받을 수 있다.
이러한 문제는 유료 데이터의 접근을 차단하는 테스트만으로 해결되지 않는다.
또한 실제 새로운 코드가 검사 대상 디렉터리 밖에 추가된다면 일부 문제가 발생할 수 있다.
따라서 아키텍처 테스트를 유지하는 작업도 필요하다.
이번 글은 서비스가 사용자에게 약속한 비즈니스 정책을 단순한 개발 문서로 남기지 않고, Import 규칙과 Schema 검사, 실제 데이터베이스 통합 테스트로 강제할 수 있다는 점을 보여주는 설계 사례다.
Auto-stitching scrolling screenshots in TypeScript — 빈 여백 때문에 두 Screenshot이 잘못 이어지는 문제 해결
- 저자: Ken
- 매체: DEV Community / Imagier
- 게시일: 2026-11-20
- 기술: TypeScript, Canvas API, ImageBitmap, Pixel Sampling, 이미지 매칭 알고리즘
- 원문: https://dev.to/kenrl/auto-stitching-scrolling-screenshots-in-typescript-without-false-matches-on-blank-margins-145g
스크롤하면서 촬영한 여러 Screenshot을 하나의 긴 이미지로 합치는 기능을 구현하면서 빈 배경과 여백 때문에 이미지의 중첩 위치를 잘못 계산하는 문제를 해결한 기술 글이다.
작성자는 브라우저 기반 이미지 도구인 Imagier의 Screenshot Stitcher를 개발했다.
사용자는 여러 장의 Screenshot을 업로드한다.
도구는 인접한 두 이미지에서 같은 내용이 존재하는 영역을 찾는다.
이후 실제로 중복된 부분을 제거하고 하나의 긴 이미지로 합친다.
문제는 단순한 Pixel 비교 알고리즘이 실제 웹사이트의 여백에서 잘못된 결과를 만든다는 점이었다.
기본적인 중첩 위치 탐색
예를 들어 다음 두 이미지가 있다고 가정해 보자.
첫 번째 이미지는 웹페이지의 상단을 촬영했다.
두 번째 이미지는 조금 아래로 스크롤한 뒤 촬영했다.
두 이미지에는 같은 콘텐츠가 일부 포함돼 있을 수 있다.
따라서 첫 번째 이미지의 아래쪽과 두 번째 이미지의 위쪽을 비교하면 중첩 구간을 찾을 수 있다.
가장 단순한 방식은 다음과 같다.
- 중첩 높이 후보 선택
- 두 이미지의 Pixel 비교
- 색상 차이 계산
- 차이가 가장 작은 높이 선택
하지만 실제 웹사이트에는 단순한 배경이 많이 존재한다.
예를 들어 다음 영역이다.
- 흰색 여백
- 단색 Header
- 검정 배경
- 콘텐츠 사이의 넓은 Padding
이러한 영역에서는 서로 다른 위치라도 Pixel 값이 거의 같을 수 있다.
빈 여백의 오류
예를 들어 첫 번째 이미지의 아래쪽이 모두 흰색이라고 가정해 보자.
두 번째 이미지의 위쪽에도 흰색 여백이 존재한다.
이 경우 두 영역의 Pixel 차이는 0에 가까울 수 있다.
하지만 실제로는 서로 같은 콘텐츠 위치를 나타내는 것이 아닐 수 있다.
단순히 Pixel 차이가 가장 작은 위치를 선택하면 잘못된 중첩 구간을 찾을 수 있다.
그 결과 실제 콘텐츠가 누락되거나 중복될 수 있다.
작성자는 이러한 문제를 해결하기 위해 색상 차이와 이미지의 정보량을 함께 평가했다.
전체 이미지 대신 작은 Strip 사용
실제 Screenshot의 너비는 수천 Pixel일 수 있다.
예를 들어 Retina Screenshot의 너비가 2,800px이라고 가정해 보자.
전체 이미지를 여러 중첩 높이에서 반복해서 비교하면 계산량이 커진다.
따라서 작성자는 이미지를 작은 Strip으로 축소했다.
기본 너비는 다음과 같다.
96px
원본 이미지가 2,800px이어도 실제 비교에는 96px 너비의 축소된 데이터를 사용한다.
이렇게 하면 비교해야 하는 Pixel 수가 크게 줄어든다.
하지만 이미지를 축소하면 작은 글자나 경계 정보가 사라질 수 있다.
따라서 실제 정확성과 계산 속도 사이에 트레이드오프가 존재한다.
Canvas Sampling
저자는 Canvas API를 사용했다.
대표적인 처리 과정은 다음과 같다.
- 이미지의 원래 크기 확인
- 비교용 Canvas 생성
- 이미지 축소
- getImageData() 실행
- RGBA Pixel Buffer 생성
Canvas Context에서는 다음 설정을 사용했다.
willReadFrequently: true
이는 Pixel 데이터를 여러 번 읽는 작업에 적합한 실행 경로를 선택하도록 브라우저에 힌트를 제공한다.
하지만 이 설정이 모든 브라우저에서 일정한 비율의 속도 향상을 보장하는 것은 아니다.
실제 Canvas 구현과 사용 패턴에 따라 효과가 달라질 수 있다.
가로 결합과 세로 결합
작성자는 가로 결합을 위해 별도의 매칭 알고리즘을 작성하지 않았다.
대신 가로 이미지를 90도 회전해 Sampling했다.
이후 같은 세로 결합 알고리즘을 사용했다.
즉 실제 입력 방향을 정규화하는 방식이다.
이러한 구조에서는 다음 두 경우를 하나의 알고리즘으로 처리할 수 있다.
- 위아래 Screenshot 결합
- 좌우 Screenshot 결합
따라서 방향에 따라 서로 다른 버그가 발생할 가능성을 줄일 수 있다.
중첩 높이 후보 탐색
실제 중첩 높이는 다음 범위에서 탐색한다.
- 최소 8px
- 두 Strip 가운데 짧은 쪽의 높이에서 8px을 뺀 값까지
각 후보에서 두 이미지의 Pixel 차이를 계산한다.
하지만 모든 Pixel을 비교하지 않는다.
세로 방향에서는 실제 중첩 높이에 따라 Sample 간격을 조절한다.
대표적인 계산은 다음과 같다.
max(1, floor(overlap / 36))
가로 방향에서는 세 Pixel마다 하나를 검사한다.
이렇게 하면 실제 중첩 높이가 커져도 비교하는 Sample 수를 제한할 수 있다.
RGB 차이
작성자는 각 Pixel의 RGB 차이를 계산했다.
대표적인 계산은 다음과 같다.
abs(r1-r2) + abs(g1-g2) + abs(b1-b2)
이후 전체 Sample 수로 나눠 평균적인 색상 차이를 구한다.
두 이미지의 같은 콘텐츠가 정확히 일치한다면 해당 값은 작아질 수 있다.
하지만 앞서 설명한 것처럼 빈 여백도 매우 작은 차이를 가질 수 있다.
따라서 색상 차이만으로 중첩 구간을 선택하지 않는다.
Luminance Variance
두 번째 조건은 밝기의 분산이다.
작성자는 RGB 값을 이용해 간단한 Luminance 값을 계산했다.
대표적인 식은 다음과 같다.
(R×3 + G×6 + B) / 10
이후 실제 Sample의 평균 밝기와 제곱 평균을 이용해 분산을 계산한다.
E[Y²] - E[Y]²
예를 들어 모든 Pixel이 흰색이라면 밝기 값이 거의 같다.
따라서 분산은 0에 가깝다.
반면 텍스트와 선, 이미지가 포함된 영역에서는 밝기가 서로 다르다.
따라서 분산이 커질 수 있다.
작성자는 다음 기준을 사용했다.
variance > 100
따라서 밝기의 변화가 거의 없는 영역을 후보에서 제외한다.
이것이 빈 여백으로 인한 잘못된 매칭을 줄이는 핵심이다.
최종 중첩 판단
작성자는 다음 조건을 결합했다.
- Luminance Variance가 100 초과
- 평균 RGB Error가 12 미만
두 조건을 만족하는 경우에만 중첩 구간으로 인정한다.
이후 다음 식으로 Confidence를 계산한다.
max(0, 1 - error / 12)
예를 들어 Error가 0이라면 Confidence는 1이다.
Error가 6이라면 Confidence는 0.5다.
하지만 이 값은 실제 매칭이 올바를 통계적인 확률을 의미하지 않는다.
단순히 작성자가 정의한 Error 기준에서 계산한 신뢰도 점수다.
수동 조정의 필요성
이번 알고리즘도 모든 Screenshot을 완벽하게 결합하지는 못한다.
예를 들어 다음 UI가 존재할 수 있다.
- Sticky Header
- Animated Banner
- 동적으로 변경되는 광고
- 무한 스크롤 목록
- 화면에 계속 고정되는 Floating Button
이러한 요소는 서로 다른 Screenshot에서 실제 위치와 내용이 달라질 수 있다.
따라서 자동으로 중첩을 계산하기 어려울 수 있다.
작성자는 실제 사용자가 중첩 높이를 수동으로 조정할 수 있도록 했다.
Screenshot 순서를 변경할 때
이번 글에는 작은 UX 설계도 포함돼 있다.
예를 들어 다음 이미지가 있다고 가정해 보자.
- A
- B
- C
- D
사용자가 C를 다른 위치로 이동했다.
이 경우 모든 이미지의 중첩 값을 무조건 초기화할 필요는 없다.
실제로 이전 이웃 관계가 변경된 이미지 쌍만 다시 계산하면 된다.
따라서 작성자는 각 Screenshot의 이전 이웃 ID를 기록했다.
이후 순서가 변경됐을 때 실제 연결 관계가 달라진 쌍만 중첩 값을 초기화했다.
이렇게 하면 사용자가 이미 수동으로 조정한 다른 이미지의 설정이 유지된다.
실제 성능과 한계
이번 도구는 TypeScript와 Canvas로 구현됐다.
별도의 외부 이미지 처리 의존성 없이 브라우저에서 실행할 수 있다.
따라서 사용자 이미지를 서버에 업로드하지 않고 처리할 수 있다.
하지만 다음 수치는 제공되지 않았다.
- 전체 이미지 결합 시간
- 원본 크기별 처리량
- 자동 매칭 성공률
- 여러 종류의 UI에서의 정확도
- 독립적인 Benchmark
또한 variance > 100과 error < 12는 작성자가 실제 UI Screenshot에 맞춰 선택한 Heuristic이다.
모든 이미지에서 최적의 Threshold라고 보장할 수는 없다.
이번 글은 이미지 매칭에서 단순한 색상 차이만으로 후보를 선택하지 않고 실제 데이터의 정보량까지 고려해야 하며, 자동화의 불확실성을 수동 조정 UI로 보완하는 방법을 보여주는 구현 사례다.
Postmortem: A MutationObserver Feedback Loop Froze a Production Website — DOM 변경 감시가 스스로를 다시 실행해 브라우저를 멈춘 장애
- 저자: Muhammad Farhan
- 매체: DEV Community
- 게시일: 2026-11-20
- 기술: JavaScript, MutationObserver, DOM, 국제화, 이벤트 처리, 성능 디버깅
- 원문: https://dev.to/muhammad_farhan/postmortem-a-mutationobserver-feedback-loop-froze-a-production-website-406n
실제 운영 중인 웹사이트에서 사용자가 페이지를 열면 브라우저가 응답하지 않던 문제를 분석한 장애 회고다.
작성자는 처음에 특정 기기의 성능이나 브라우저 문제를 의심했다.
하지만 실제 원인은 JavaScript의 DOM 변경 감시 로직이었다.
특히 MutationObserver가 자신의 Callback에서 변경한 DOM을 다시 감시하면서 무한에 가까운 반복 작업을 생성했다.
실제 장애
2026년 11월 20일 약 45명의 사용자가 웹사이트가 멈춘다고 보고했다.
사용자가 경험한 문제는 다음과 같았다.
- 페이지가 응답하지 않음
- 스크롤이 멈춤
- 버튼을 클릭해도 반응 없음
- Chrome에서 Not Responding 표시
- 모바일 기기에서도 비슷한 문제 발생
문제는 특정 기기 하나에서만 발생하지 않았다.
따라서 작성자는 실제 JavaScript 실행 경로를 조사했다.
국제화 Script
문제가 발생한 파일은 다음과 같다.
public/scripts/i18n.js
이 파일은 웹페이지의 언어를 변경하는 기능을 담당했다.
예를 들어 사용자가 영어를 선택했다고 가정해 보자.
화면에 표시되는 여러 문장을 영어로 변경해야 한다.
작성자는 다음 함수를 사용했다.
applyLanguage()
이 함수는 DOM의 텍스트를 변경한다.
하지만 실제 웹사이트에서는 동적으로 생성되는 요소도 존재했다.
따라서 작성자는 MutationObserver를 이용해 DOM 변경을 감시했다.
MutationObserver
MutationObserver는 DOM의 변경을 관찰하는 JavaScript API다.
대표적으로 다음 종류의 변경을 감시할 수 있다.
- childList
- characterData
- subtree
예를 들어 새로운 DOM 요소가 추가됐다고 가정해 보자.
MutationObserver는 해당 변경을 감지한다.
이후 Callback을 실행한다.
작성자의 코드에서는 Callback이 다음 함수를 호출했다.
applyLanguage()
이러한 방식은 동적으로 생성한 요소에도 번역을 적용하는 데 사용할 수 있다.
하지만 실제 Callback이 다시 DOM을 변경한다는 점이 문제였다.
무한 Feedback Loop
기존 실행 흐름은 다음과 같았다.
- DOM 변경 발생
- MutationObserver Callback 실행
applyLanguage()호출- 텍스트 Node 변경
- 새로운 Mutation Record 생성
- MutationObserver Callback 재실행
- 같은 과정 반복
즉 감시 대상의 변경을 처리하는 코드가 다시 감시 대상의 변경을 생성했다.
이러한 구조에서는 실제 Callback의 실행이 계속 이어질 수 있다.
따라서 메인 JavaScript 스레드에서 많은 작업이 발생한다.
브라우저는 사용자 입력과 화면 업데이트를 처리해야 한다.
하지만 같은 스레드가 반복적인 DOM 변경 처리에 점유되면 실제 UI가 멈출 수 있다.
수정 방법
작성자는 실제 번역을 적용하는 동안 Observer를 비활성화하도록 변경했다.
새로운 순서는 다음과 같다.
- MutationObserver 연결 해제
applyLanguage()실행- Observer 다시 연결
대표적인 API는 다음과 같다.
observer.disconnect()
중요한 부분은 다시 연결하는 시점이다.
작성자는 finally 블록에서 Observer를 다시 연결하도록 했다.
따라서 applyLanguage()에서 오류가 발생하더라도 Observer가 비활성화된 상태로 영구적으로 남지 않도록 했다.
이렇게 하면 번역 코드 자신이 생성한 DOM 변경을 다시 감시하는 문제를 줄일 수 있다.
중복 이벤트 리스너 제거
이번 조사에서는 별도의 중복 이벤트 리스너도 발견됐다.
언어 선택 기능에는 이미 직접적인 Event Handler가 존재했다.
하지만 Delegated Change Listener도 같은 작업을 처리하고 있었다.
따라서 하나의 사용자 입력에서 같은 언어 변경 로직이 여러 번 실행될 수 있었다.
작성자는 중복된 Delegated Listener를 제거했다.
그리고 기존 언어 선택 요소의 직접적인 Event Handler를 유지했다.
이러한 수정은 불필요한 실행을 줄이기 위한 것이다.
실제 검증
수정 이후 작성자는 다음 결과를 확인했다.
- Production Deployment가 READY 상태에 도달
- CI 검사 15개 모두 통과
- 한 명의 사용자가 노트북에서 약 15초 동안 테스트
- 해당 짧은 테스트에서는 기존 화면 정지 현상이 나타나지 않음
또한 같은 종류의 문제가 다시 발생하지 않도록 Regression Check를 추가했다.
하지만 중요한 제한사항이 있다.
이번 짧은 테스트만으로 장애가 모든 환경에서 완전히 해결됐다고 확정할 수는 없다.
작성자도 모바일 기기에서의 검증이 추가로 필요하다고 명시했다.
또한 운영 환경의 장기적인 CPU 사용량이나 페이지 응답성에 관한 정량적인 Benchmark는 제공하지 않았다.
MutationObserver 설계의 다른 고려 사항
이번 수정은 실제 장애의 원인을 해결하기 위한 것이다.
하지만 모든 MutationObserver에서 무조건 disconnect()를 호출해야 하는 것은 아니다.
예를 들어 Observer를 비활성화한 사이에 다른 코드에서 DOM 변경이 발생할 수 있다.
이 경우 해당 변경이 감시되지 않을 가능성이 있다.
따라서 실제 구조에 따라 다음 방법을 검토할 수 있다.
- 특정 DOM 영역만 관찰
- 실제 변경된 Node만 처리
- 이미 번역된 Node는 다시 처리하지 않음
- Observer를 일시 중단
- 변경 작업의 중복 실행 방지
이번 글은 이러한 방법을 모두 비교한 Benchmark는 아니다.
실제 장애에 적합했던 수정 방법을 설명한다.
적용 범위와 한계
이번 사례는 특정 웹사이트의 국제화 Script에서 발생한 장애다.
따라서 모든 MutationObserver가 같은 방식으로 브라우저를 멈추게 만드는 것은 아니다.
실제 Callback에서 어떤 DOM 변경을 수행하는지, 어느 범위의 Node를 감시하는지에 따라 결과가 달라진다.
또한 초기 원인 분석에는 AI 도구가 사용됐지만 실제 Source Code를 확인하고 수정 및 검증한 과정이 별도로 수행됐다고 작성자는 설명한다.
이번 글은 비동기적으로 DOM 변경을 감시하는 코드에서도 자기 자신이 발생시킨 변경을 다시 처리하는 Feedback Loop가 만들어질 수 있으며, 빌드와 CI가 통과했다는 사실만으로 실제 브라우저의 응답성이 보장되지 않는다는 점을 보여주는 운영 장애 사례다.