이번 소식
Cloudflare가 2026년 10월 20일 Workers 배포 도구의 소스맵 기본 업로드를 발표했습니다. Wrangler 4.150.0부터 배포·버전 업로드·미리보기 명령에서 별도 설정 없이 소스맵을 생성하고 올립니다. 소스맵은 오류 기록을 개발자가 작성한 원래 파일명과 줄 번호에 연결하는 데 쓰입니다.
달라진 점
대상 명령은 wrangler deploy, wrangler versions upload, wrangler preview입니다. 이전처럼 upload_source_maps를 따로 켜지 않아도 원본 코드 위치가 표시된 오류 실행 경로를 볼 수 있습니다.
cf deploy도 소스맵을 기본 업로드합니다. Cloudflare Vite plugin 1.64.0 이상은 Worker 빌드 때 소스맵을 기본 생성하고, cf는 빌드 결과에 있는 소스맵을 업로드합니다.
어떤 점이 달라지나요?
Workers를 운영하는 개발자는 오류가 난 곳을 확인할 때 배포된 코드 대신 원래 작성한 파일과 줄 번호를 기준으로 살펴볼 수 있습니다. 이 표시는 Workers Logs, 실시간 로그, Tail Workers, Workers Issues에 적용됩니다. 일반 이용자용 화면 기능이 아니라 서비스 오류를 조사하는 개발 도구의 변경입니다.
Cloudflare 설명에 따르면 소스맵은 Worker 실행이 끝난 뒤 적용되므로 CPU 실행 시간, 코드 묶음 크기, 초기 시작 시간에 영향을 주지 않습니다.
사용 전 확인할 점
자체 빌드 방식을 쓰면 Wrangler가 발견한 외부 소스맵을 업로드합니다. 인라인 data: 소스맵처럼 해석하지 못한 항목은 기본적으로 건너뜁니다. 이런 경우 업로드 실패로 처리하려면 upload_source_maps를 true로 명시합니다.
업로드를 원하지 않으면 Wrangler에서는 upload_source_maps: false를 설정합니다. cf 또는 Cloudflare Vite plugin에서는 해당 Worker의 Vite 환경에 build.sourcemap: false를 지정합니다.
공식 발표일: 2026년 10월 20일
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.