React Native 기반 프로젝트에서 iOS 기기에서 사진을 선택한 후 피드를 작성하려 할 때, 간헐적으로 이미지 업로드가 실패하는 문제가 발생했습니다.

문제 추측 순서

스크린 이동 중 이미지 누락? → ❌

사진선택/글쓰기/위치 선택 등 여러 스크린을 거치는 구조였기에, 중간에 이미지 경로가 사라졌을 가능성을 의심했으나, 로그를 통해 정상적으로 URI가 전달되는 것이 확인되었습니다.

백엔드 이미지 수신 실패? → ❌

백엔드에서는 이미지가 빈 상태로 도착. sharp 사용하여 리사이징 처리중에 GIF 파일을 지원하지 않아서 생기는 문제를 발견함. 하지만 근본적인 문제 해결은 아니었습니다.

EC2 로컬 저장 → S3 전환 → ❌

초기에 EC2에 로컬 저장하던 구조였으나, 해당 문제는 S3 저장 방식으로 전환한 이후에도 동일하게 발생했습니다.

S3에 올라간 파일 확인 → 용량 0KB

프로덕트에서 에러 디버깅하여, 실제 S3 버킷에 업로드된 파일을 직접 확인한 결과, 파일은 존재하나 용량은 0. 즉, 이미지 경로는 존재하나 내용이 없는 파일이 업로드되고 있었습니다.

그럼 왜? 빈 파일이 업로드 됐나?

문제 분석

iCloud 최적화 이미지? → ❌

iOS의 “저장 공간 최적화” 설정 시 사진이 로컬에 없고 iCloud에만 저장되어 있는 경우, react-native-image-picker로 선택 시 width/height가 0이고 URI만 전달된다는 이슈가 존재했습니다.
그러나 테스트 결과, 이 경우 해당 사진은 앨범 목록 자체에 표시되지 않았으며, 실제 발생한 문제와는 관련이 없었습니다.

사용자 동작 타이밍 오류? → ❌

사용자가 사진을 선택하자마자 화면을 빠르게 이동하거나 백그라운드로 넘기면서, 임시 이미지 파일을 접근하기 전에 유실되었을 가능성도 테스트했지만, 동일 상황을 재현할 수 없었습니다.

파일 포맷이나 용량 문제? → ❌

GIF나 20MB 이상 대용량 이미지의 경우도 테스트했으나, 이미 프론트에서 용량 필터링 로직이 존재하고, GIF 또한 정상적으로 업로드됨을 확인했습니다.(sharp 문제 해결 후)

임시 파일 삭제 가능성? → ✅ 유력한 원인

가장 가능성이 높은 원인은 react-native-image-picker가 iOS에서 이미지를 임시 디렉토리에 저장하기 때문에 발생하는 문제입니다.

해당 디렉토리는 app-specific cache storage이며, 시스템 메모리 압박 시 언제든지 해당 임시 파일이 삭제될 가능성이 있습니다.

공식 문서 참고 내용

Note on file storage
Image/video captured via camera will be stored in temporary folder allowing it to be deleted any time, so don't expect it to persist.
Use saveToPhotos: true (default is false) to save the file in the public photos.

즉, react-native-image-picker에서 임시 파일을 영구 저장 용도로 쓰지 말 것을 명시하고 있다.

임시 해결방안

프론트에서 이미지 업로드하기 전 이미지 파일 체킹하여 없을 시 이미지 재선택 하는 방식을 택했습니다.

참고

react-native-image-picker iCloud image issue

GitHub Issue #2280

npm 공식 문서 - Asset Object

React Native iOS에서 빈 이미지 파일 발생