💡 “같은 이미지 또 올리세요?”

LinkDropper·2025년 5월 13일

S3 aws 링크 드라퍼 최적화

Link Dropper

목록 보기

8/12

💬 반복 업로드, 사소하지만 무서운 비용

이미지를 업로드하는 기능은 대부분의 서비스에서 필수입니다.
사용자 프로필, 게시글 썸네일, 콘텐츠 내 첨부 이미지까지.

처음엔 문제없어 보이지만,
“같은 이미지가 여러 번 업로드된다면?”

저장 용량 낭비
S3 트래픽 요금 증가
관리 난이도 상승
그리고... 💸 요금 폭탄

특히 S3는 전송량 + 저장량 모두 과금되기 때문에
같은 이미지를 중복으로 올릴수록 서비스 전체 비용이 기하급수적으로 올라갑니다.

📦 중복 이미지 판단, 어떻게 할까?

단순히 filename으로 판단하기엔 위험합니다.
사용자는 같은 이미지를 이름만 다르게 올릴 수도 있고,
같은 이름의 완전히 다른 이미지일 수도 있습니다.

그래서 필요한 건?

✅ 이미지 자체의 내용을 기준으로 판단하는 것

→ 가장 안정적이고 효율적인 방식이 바로
→ 이미지를 해시값으로 변환하는 방법입니다.

🔑 해시 기반 S3 업로드 로직 설계

흐름은 단순합니다:

이미지를 읽어서 해시값(SHA-256 등)을 생성
해당 해시값을 기반으로 S3 Key(Path)를 구성
S3에 해당 Key가 존재하는지 HeadObject로 확인
존재한다면? ➜ 업로드 생략 (URL만 반환)
없다면? ➜ 새로 업로드 진행

이 방식의 가장 큰 장점은:

정확하다 – 동일한 이미지라면 언제나 같은 해시값
간편하다 – 추가 DB 없이 S3 자체를 중복 판단 기준으로 활용
빠르다 – 업로드 생략으로 I/O 줄어듦
저렴하다 – 중복 파일 최소화로 비용 절감

🧪 실전 예시 (Node.js + AWS SDK v3)

import crypto from 'crypto';
import { S3Client, HeadObjectCommand, PutObjectCommand } from '@aws-sdk/client-s3';

const s3 = new S3Client({
  region: 'ap-northeast-2',
  credentials: {
    accessKeyId: process.env.AWS_ACCESS_KEY!,
    secretAccessKey: process.env.AWS_SECRET_KEY!,
  },
});

const BUCKET_NAME = 'your-bucket-name';

// 1. 이미지 해시 생성
const getImageHash = async (buffer: Buffer): Promise<string> => {
  return crypto.createHash('sha256').update(buffer).digest('hex');
};

// 2. S3에 해당 이미지 존재 여부 확인
const checkIfImageExists = async (hash: string): Promise<boolean> => {
  try {
    await s3.send(new HeadObjectCommand({
      Bucket: BUCKET_NAME,
      Key: `images/${hash}.jpg`,
    }));
    return true;
  } catch (e) {
    return false;
  }
};

// 3. 최종 업로드 함수
const uploadImageIfNeeded = async (buffer: Buffer): Promise<string> => {
  const hash = await getImageHash(buffer);
  const key = `images/${hash}.jpg`;

  const exists = await checkIfImageExists(hash);
  if (exists) {
    console.log(`✅ 중복 이미지입니다. 업로드 생략 → ${key}`);
    return key;
  }

  await s3.send(new PutObjectCommand({
    Bucket: BUCKET_NAME,
    Key: key,
    Body: buffer,
    ContentType: 'image/jpeg',
  }));

  console.log(`📤 이미지 업로드 완료 → ${key}`);
  return key;
};