피드로 돌아가기
Dev.toBackend
원문 읽기
Multer를 통한 multipart/form-data 스트림 파싱 및 바이너리 파일 처리 최적화
Handling File Uploads in Express with Multer
AI 요약
Context
HTTP 요청의 기본 텍스트 데이터 처리 방식인 express.json()으로는 바이너리 형태의 파일 데이터를 처리하는 데 한계가 존재함. 파일 데이터는 Raw bytes로 구성되어 일반적인 텍스트 기반 파싱으로는 효율적인 처리가 불가능한 구조임.
Technical Solution
- multipart/form-data 형식을 통한 텍스트와 바이너리 데이터의 통합 전송 구조 채택
- HTTP Request Body를 거대한 패킷이 아닌 Chunk 단위의 Stream으로 수신하여 메모리 부하 감소
- Multer Middleware를 통한 Request Stream의 수동 파싱 및 Boundary 기반의 데이터 분리
- 파싱된 파일 바이너리를 fs.writeFile() 또는 Stream Pipe를 통해 디스크에 직접 기록하는 구조 설계
- 파일 메타데이터(MIME type, originalname 등)를 추출하여 req.file 객체로 제공하는 추상화 계층 구현
- upload.single() 및 upload.array() 메서드를 통한 파일 수신 전략의 유연한 제어
실천 포인트
1. Frontend의 form enctype이 multipart/form-data로 설정되었는지 확인
2. Backend의 Multer 설정 필드명과 Frontend의 input name 일치 여부 검증
3. 파일 저장 경로(dest) 폴더의 물리적 존재 여부 및 쓰기 권한 확인
4. 업로드 파일의 정적 접근을 위한 express.static() 미들웨어 설정 적용
5. 파일명 충돌 방지를 위해 Date.now() 등을 활용한 고유 파일명 생성 로직 적용