본문 바로가기
2026년 5월 15일2분 읽기

Next.js 17 Server Action에서 파일 업로드 5MB 이상이면 timeout — 우회 패턴이 뭔가요

김
김영삼
조회 612댓글 4

Next 17의 Server Action으로 파일 업로드 처리하고 있습니다. 작은 이미지(2~3MB)는 잘 되는데, 5MB 이상 PDF·동영상은 거의 항상 timeout이 납니다.

'use server'
export async function uploadAction(formData: FormData) {
  const file = formData.get('file') as File
  const buf = Buffer.from(await file.arrayBuffer())
  await s3.send(new PutObjectCommand({ Bucket, Key, Body: buf }))
  return { success: true }
}

현재 Vercel 호스팅, Edge가 아닌 Node runtime입니다. 1024MB 메모리 할당했는데도 30초 timeout에 걸립니다.

presigned URL로 클라이언트에서 직접 S3에 업로드하면 되긴 하는데, RLS·권한 체크 흐름이 복잡해집니다. Server Action을 살리고 5MB 이상도 처리할 방법이 있을까요?

댓글 4

김김영삼6개월 전

Server Action으로 큰 파일 업로드는 구조적으로 어렵습니다. 이유를 먼저 정리하고 우회 패턴을 보여드립니다.


왜 막히나



  • Server Action은 RPC라 multipart 전체를 메모리에 받아 직렬화 → 한 번 더 S3로 PUT. 메모리·시간 2배

  • Vercel function payload 한계 4.5MB(Hobby) / 50MB(Pro). Server Action도 이 한계 적용

  • Edge runtime은 더 작음(1MB)


우회 1 — presigned URL (정석)


"권한 체크 흐름이 복잡"이라 하셨는데 사실 Server Action에서 presigned 발급만 받으면 깔끔합니다:


// app/actions/upload.ts
'use server'
export async function getUploadUrl(fileName: string, contentType: string) {
const session = await getSession()
if (!session) throw new Error('Unauthorized')
// 권한 체크는 여기서
if (!canUpload(session.user)) throw new Error('Forbidden')

const key = `uploads/${session.user.id}/${nanoid()}-${fileName}`
return await getSignedUrl(s3, new PutObjectCommand({
Bucket, Key: key, ContentType: contentType,
}), { expiresIn: 300 })
}

// client
const url = await getUploadUrl(file.name, file.type)
await fetch(url, { method: 'PUT', body: file })

권한 체크는 발급 단계에서 끝납니다. 5MB도 100MB도 문제 없고 progress 표시도 native fetch가 지원.


우회 2 — multipart 직접 처리


꼭 Server Action 형태를 유지하려면 streaming. request.formData() 대신 raw Request의 body를 chunk로 받아 S3 multipart upload로 분할 전송. 코드가 복잡하고 timeout도 여전히 걸려서 권장 안 합니다.


우회 3 — Vercel Blob


Vercel Blob의 client upload는 정확히 이 케이스를 위해 만든 API입니다. presigned 발급을 자동 처리해주는 SDK. 인프라가 Vercel이면 이게 가장 간단:


// app/actions/blob.ts
'use server'
import { handleUpload } from '@vercel/blob/client'
export async function generateClientToken(body, request) {
return handleUpload({
body, request,
onBeforeGenerateToken: async () => {
const session = await getSession()
if (!session) throw new Error('Unauthorized')
return { allowedContentTypes: ['image/*', 'application/pdf'], maxSize: 100 * 1024 * 1024 }
},
})
}

1번 또는 3번이 정답입니다. Server Action 안에서 multipart 받는 건 5MB 이상이면 사실상 못 씁니다.

프프론트수진6개월 전

저는 R2 사용 중인데 동일하게 presigned 패턴입니다. 단 R2는 multipart upload가 무료라서 5MB 이상도 자동 분할 전송하면 비용 부담이 없어요. AWS S3는 multipart 자체는 무료지만 incomplete upload 부분이 30일 후에 자동 삭제 안 되니 lifecycle 정책 필수입니다.

ssjmoon(guest)6개월 전
presigned 발급 시 expiresIn을 너무 길게 잡으면(예: 3600초) URL이 유출됐을 때 위험합니다. 5분이면 충분하고, 클라이언트 업로드 실패하면 다시 발급받게 하세요.
한한가은(guest)6개월 전
저도 같은 문제로 머리 아팠는데 Vercel Blob 도입 후 깔끔해졌습니다. 비용은 storage 1GB당 $0.15라 작은 서비스는 부담 안 되는 수준입니다.
Ctrl+Enter로 등록