Storage 업로드는 됐는데 photos insert가 실패했던 문제

이미지 업로드 기능에서는 파일이 Storage에 올라가는 것과 photos 테이블에 기록이 남는 것이 별개의 단계다. 처음에는 파일 업로드만 보고 성공처럼 느꼈지만, 이후 분석 세션과 사진을 연결하려면 DB row가 반드시 필요했다.

문제는 Storage 업로드 이후 photos insert에서 실패가 날 수 있다는 점이었다. 이 경우 사용자는 이미지를 올렸다고 생각하지만, 서버 입장에서는 분석에 쓸 사진 기록이 없는 상태가 된다.

업로드 API에서 서버 전용 Supabase 키를 사용하도록 분리했다. 클라이언트에서 써도 되는 공개 키와 서버에서 DB insert를 수행할 때 필요한 권한은 다르게 다뤄야 했다.

또 photos 테이블에 들어갈 id를 서버에서 명시적으로 만들고, image_path, image_url, source 같은 최소 정보를 함께 저장했다. 파일과 DB row를 같은 응답 흐름에서 확인할 수 있게 만든 것이다.

파일 기반 기능은 항상 두 단계를 본다. 저장소에 객체가 생겼는지, 데이터베이스에 그 객체를 참조하는 row가 생겼는지다.

둘 중 하나만 성공하면 나중에 더 복잡한 문제가 된다. 그래서 업로드 API는 성공 응답을 만들기 전에 Storage와 DB insert를 모두 확인해야 한다.