목록으로
Web Framework 2026-10-29 공식 릴리스 · 3.1.0은 10-14

SvelteKit 3.1.1: 서버 경계·폼 처리 수정과 endpoint 추적

2026년 10월 29일 공개된 SvelteKit 3.1.1은 Kit 3 전환 이후의 경로 해석·서버 경계·폼 처리 문제를 고칩니다. 10월 14일의 3.1.0과 같은 날 갱신된 adapter도 함께 보면, 새 API 도입보다 기존 앱의 운영 경로를 확인할 이유가 분명해집니다.

11월 3일 기준 공식 GitHub 릴리스와 문서를 확인했습니다. 3.1.0의 기능 추가와 3.1.1의 수정을 구분하며, remote functions는 여전히 Experimental·명시적 opt-in 대상입니다.

공식 출처: SvelteKit 3.1.1 공식 GitHub 릴리스

이번 릴리스의 중심 메시지

Kit 3으로 옮긴 앱이 잘못된 요청과 배포 실패를 어떻게 처리하는지까지 확인합니다.

이는 공식 수정을 운영 관점으로 묶은 해석입니다. 릴리스 노트만으로 모든 앱의 영향이나 과거 피해를 추정하지 않고, 사용하는 기능과 배포 adapter부터 좁혀 봅니다.

1. 사용자 기능 단위별 가치

기능 단위주요 사용자사용자가 느끼는 문제업데이트 가치사용자에게 와닿는 메시지
경로·서버 전용 모듈서버 경계를 관리하는 개발자특정 경로와 import에서 경계가 의도대로 동작하지 않음경로 해석과 브라우저 import 차단 수정정상 화면 밖의 요청도 확인한다
remote form·query.batchremote functions 평가 팀폼 파싱과 함수별 batch 분리가 필요선형 시간 파싱·서로 다른 batch 혼합 방지같은 API의 경계 동작을 점검한다
endpoint span · 3.1.0성능·장애 담당자+server 처리 시간이 추적에서 빠짐서버 tracing 활성화 시 endpoint span 제공느린 요청의 위치를 좁힌다
배포 복구·adapter배포 담당자service worker와 호스팅 규칙의 예외가 있음복구 흐름과 플랫폼별 출력 수정패키지 버전과 배포 결과를 함께 확인한다

2. 가치 기준별 핵심 변화

A. 서버 경계: 잘못된 경로와 import 처리 확인

3.1.1은 reroute가 잘못된 pathname으로 재작성했을 때 예외 대신 400 응답을 반환하도록 수정합니다. //로 시작하는 경로의 서버 측 route resolution이 다른 origin의 코드를 불러오지 않도록 하고, src/params.js를 통한 서버 전용 모듈의 브라우저 import도 막습니다.

앱의 인증·입력 검증까지 대신하는 수정은 아닙니다. 사용 중인 reroute와 parameter matcher가 있다면 잘못된 경로의 응답, 브라우저 번들의 서버 전용 의존성 차단을 우선 확인할 수 있습니다.

B. remote functions: 수정과 안정화 선언을 구분

remote form 제출을 선형 시간으로 파싱하고, 서로 다른 비공개 query.batch 함수가 batch를 공유하지 않도록 수정했습니다. SSR을 끈 앱의 reload에서는 function snapshot을 복원하는 수정도 포함됩니다. 각 수정은 해당 사용 경로에 관한 것이며 SSR을 끄라는 권장이 아닙니다.

현재 공식 문서는 experimental.remoteFunctions와 compilerOptions.experimental.async의 opt-in을 요구합니다. 이미 평가 중인 팀은 여러 batch 함수와 폼 제출을 확인하고, 아직 쓰지 않는 앱은 패치 적용과 새 실험 기능 도입을 별도 결정으로 다룰 수 있습니다.

제공 상태·설정: 공식 Remote functions 문서

C. 관찰 가능성: endpoint 처리도 추적에 포함

3.1.0부터 서버 tracing이 켜져 있으면 +server handler에 sveltekit.endpoint span을 내보냅니다. API 요청의 처리 지점을 추적하려는 팀이 먼저 살펴볼 기능입니다.

설정의 tracing.server를 켜는 것과 데이터를 수집하는 것은 별개입니다. 공식 문서는 src/instrumentation.server.ts에서 수집 구성을 하고, 플랫폼과 adapter의 지원 여부도 확인하도록 안내합니다. 업데이트만으로 관측 대시보드가 생기는 것은 아닙니다.

버전 근거: 3.1.0 릴리스 · 활성화·수집: 공식 Observability 문서

D. 배포: Kit와 실제 adapter를 함께 확인

3.1.0은 service worker 업데이트가 실패해도 배포 복구를 계속하도록 수정했습니다. 3.1.1은 환경 변수 주입 때 service worker sourcemap을 보존합니다. 배포 전후의 캐시 갱신과 실패 시 복구가 중요한 앱은 이 경로를 재현할 수 있습니다.

10월 29일의 Vercel 7.0.2는 prerender 경로의 route pattern escape, Cloudflare 8.0.2는 prerender 경로가 의도하지 않은 규칙을 만들지 않도록 하는 수정을 포함합니다. Node 6.0.1은 변경 불가능한 헤더를 가진 text/event-stream 응답에서의 서버 crash를 수정했습니다. 사용하지 않는 adapter까지 바꿀 필요는 없습니다.

플랫폼별 근거: Vercel 7.0.2 · Cloudflare 8.0.2 · Node 6.0.1

3. 사용자 세그먼트별 해석

Kit 3로 옮긴 개발자

lockfile의 실제 설치 버전과 경로 처리 코드를 함께 확인하세요. 선언한 버전 범위만으로 새 패치 적용 여부를 판단하지 않습니다.

remote functions 평가 팀

기존 opt-in 상태를 유지하며 batch 분리·폼·reload 경로를 검사하세요. 패치 소식이 실험 기능의 GA 전환을 뜻하지는 않습니다.

배포·관측 담당자

사용하는 adapter의 출력과 배포 복구를 확인하세요. 서버 앱이라면 endpoint span이 수집기로 전달되는지도 검사할 수 있습니다.

4. 기능별 우선순위 평가

현재 기능을 계속 운영하는 팀을 기준으로 한 이 글의 평가입니다. remote functions를 쓰지 않는 앱에서는 관련 항목의 우선순위가 낮습니다.

우선순위기능이유
1설치 버전·서버 경계적용 여부와 요청·import의 기본 경계를 먼저 확인
2해당 adapter·배포 복구운영 플랫폼의 출력과 실패 경로에 직접 영향
3remote form·batch실험 기능을 이미 사용하는 앱에서 확인할 동작
4endpoint tracing수집 환경이 있는 팀에서 원인 추적의 빈틈 보완

5. 한 줄 포지셔닝

SvelteKit 3.1.1은 Kit 3 전환 뒤 요청·서버 경계·배포 경로의 예외를 점검하고 운영 기준을 다듬는 업데이트입니다.

요청 경계

경로 해석과 서버 전용 import 차단 확인

도입 범위

remote functions의 실험 상태와 패치 적용 구분

배포·관측

adapter 출력과 endpoint span 수집까지 검증