이미지 업로드 전에 서버에서 WebP로 정리하기

초기 업로드는 파일을 받아 Storage에 올리는 데 집중했다. 하지만 운영 화면과 모바일 화면이 늘어나면서 이미지 크기, 파일명, 확장자, content type이 조금씩 문제를 만들기 시작했다.

큰 이미지는 업로드와 표시를 느리게 만들고, 파일명이 불안정하면 저장 경로가 지저분해진다. 그래서 업로드 전에 서버에서 이미지를 한 번 정리하는 공통 계층이 필요했다.

prepareImageUpload는 content type과 파일 확장자를 보고 이미지 파일인지 판단한다. 이미지라면 회전 정보를 반영하고, 최대 크기를 제한한 뒤 WebP로 변환한다.

이미지가 아니거나 변환에 실패하면 무조건 요청을 죽이지 않고 원본 buffer와 content type을 돌려준다. 업로드 계층이 너무 공격적으로 실패하면 운영자가 단순 파일 교체도 못 하게 될 수 있기 때문이다.

프로필 사진 API에서는 multipart/form-data인지, file과 userId가 있는지 먼저 확인한다. 그 다음 안전한 파일명으로 바꾸고, 압축 결과의 확장자에 맞춰 Storage 경로를 만든다.

업로드 후에는 public URL을 profiles와 사용자 metadata에 반영한다. 파일 저장과 사용자 프로필 갱신이 함께 성공해야 앱에서 바로 새 사진을 볼 수 있다.

이미지 업로드는 Storage 기능이 아니라 제품 성능 기능이다. 압축, 파일명 정리, content type, DB 갱신을 한 흐름으로 봐야 한다.

또 압축 실패가 곧 업로드 실패는 아니다. 사용자와 운영자에게 필요한 것은 가능한 한 안전하게 저장하고, 실패 지점을 분명히 알려주는 것이다.