[프로젝트] 이미지 업로드 정책 결정 과정

PROJECT

이미지 업로드 정책 결정 과정

목차

• 1. 배경
• 2. 이미지 저장 방식 비교
• 3. 결정 내용
• 4. 정리

01. 배경

독서 습관 관리 프로젝트를 진행하면서 이미지를 저장하는 방식에 고민이 많았다. 이미지를 저장하는 방법은 크게 세 가지가 있었다. 어떤 방식이 더 좋은 선택인지 판단하기가 쉽지 않았고, 특히 AWS S3를 추천받았지만 실제로 사용하려면 AWS 계정에서 키를 별도로 발급받아야 하는 번거로움이 있어서 어떻게 처리할지 고민이 많았다.

02. 이미지 저장 방식 비교

방식 1. 외부 URL 그대로 저장

외부 서비스(알라딘 등)가 제공하는 이미지 URL을 DB에 그대로 저장하는 방식이다.

.coverImageUrl(picked.cover()) // 알라딘 CDN URL 그대로 저장

장점	단점
• 구현이 단순하고 빠름 • 별도 인프라 불필요 • S3 비용 없음	• 외부 URL이 만료/변경되면 이미지 깨짐 • 외부 도메인에 의존 • 이미지 가용성을 외부 서비스에 의존

방식 2. 서버에서 다운로드 후 S3 재업로드

외부 URL의 이미지를 서버가 다운로드한 뒤 S3에 저장하고, S3 URL을 DB에 저장하는 방식이다.

public String uploadImageFromUrl(String imageUrl) {
    URL url = new URL(imageUrl);
    URLConnection connection = url.openConnection();

    try (InputStream inputStream = connection.getInputStream()) {
        byte[] imageBytes = inputStream.readAllBytes();
        String fileName = UUID.randomUUID() + "_cover.jpg";

        s3Client.putObject(
                PutObjectRequest.builder()
                        .bucket(bucket)
                        .key(fileName)
                        .contentType("image/jpeg")
                        .contentLength((long) imageBytes.length)
                        .build(),
                RequestBody.fromBytes(imageBytes)
        );
        return "https://" + bucket + ".s3." + region + ".amazonaws.com/" + fileName;
    }
}

장점	단점
• 이미지 영속성 보장 • 외부 의존성 제거 • 이미지 관리 일원화	• AWS 키 발급 필요 • S3 비용 발생 • 구현 복잡도 증가

방식 3. 클라이언트에서 직접 S3 업로드 (Presigned URL)

서버가 S3 Presigned URL을 발급해주면, 클라이언트가 해당 URL로 직접 S3에 업로드하는 방식이다.

// 서버: Presigned URL 발급
public String generatePresignedUrl(String fileName) {
    PutObjectPresignRequest presignRequest = PutObjectPresignRequest.builder()
            .signatureDuration(Duration.ofMinutes(10))
            .putObjectRequest(r -> r.bucket(bucket).key(fileName))
            .build();
    return presigner.presignPutObject(presignRequest).url().toString();
}

// 클라이언트: Presigned URL로 직접 업로드
await axios.put(presignedUrl, file, {
    headers: { 'Content-Type': file.type }
});

장점	단점
• 서버 부하 없음 • 대용량 파일에 유리 • 네트워크 효율적	• AWS 키 발급 필요 • 구현 복잡도 가장 높음 • 클라이언트-서버 간 추가 통신 필요

03. 결정 내용

표지 이미지 (coverImageUrl)

초기에는 방식 2(서버에서 S3 재업로드)를 계획했다. 그러나 S3 키 발급 전까지 로컬 개발 환경에서 테스트가 불가능한 문제가 있었고, 알라딘 CDN URL이 당장 만료되거나 변경될 가능성이 낮다고 판단해 방식 1로 변경했다. Post 엔티티의 coverImageUrl 필드는 그대로 유지한다.

// 변경 전 (계획)
.coverImageUrl(s3Service.uploadImageFromUrl(picked.cover()))

// 변경 후 (현재)
.coverImageUrl(picked.cover())

프로필 이미지 (profileImageUrl)

사용자가 직접 업로드하는 이미지이므로 외부 URL 저장 방식을 적용할 수 없어 방식 2(S3 업로드)를 그대로 유지하기로 했다. AWS 키 발급 및 실제 연동은 D13 배포 환경 구성 단계에서 진행하고, 그 전까지는 프로필 이미지 관련 API 테스트를 스킵한다. S3Config, S3Service, UserService의 이미지 관련 코드는 그대로 유지한다.

// S3Service — 프로필 이미지 업로드 (D13에서 실제 연동)
public String uploadImage(MultipartFile image) {
    String fileName = UUID.randomUUID() + "_" + image.getOriginalFilename();
    s3Client.putObject(
            PutObjectRequest.builder()
                    .bucket(bucket)
                    .key(fileName)
                    .contentType(image.getContentType())
                    .contentLength(image.getSize())
                    .build(),
            RequestBody.fromInputStream(image.getInputStream(), image.getSize())
    );
    return "https://" + bucket + ".s3." + region + ".amazonaws.com/" + fileName;
}

04. 정리

이미지 종류	저장 방식	비고
표지 이미지	외부 URL 그대로 저장	알라딘 CDN URL
프로필 이미지	S3 업로드	D13(배포 준비 단계)에서 실제 연동

Last Sync: 2026-04-30 | Booktine Project Log