🚀 Spring Boot에서 AWS S3에 파일 업로드하기 (비속어 음성 관리)

0. 개요

프로젝트를 진행하며 사용자의 비속어 음성 파일을 저장해야 하는 기능이 추가되어.
이를 위해 AWS S3에 파일을 업로드 및 관리하기로 결정했다.

이번 글에서는 AWS S3 버킷 생성부터 Spring Boot에서 파일 업로드 코드 구현까지 다룰 예정이다.

---

1. 🛠️ 준비물

✔ AWS 계정
✔ Spring Boot 프로젝트

---

2. 🔐 IAM 사용자 생성

2-1. IAM 이동 후 사용자 클릭

2-2. 사용자 생성 클릭

2-3. 이름 등록 후 AmazonS3FullAccess 권한 부여

2-4. 로컬 코드 선택

2-5. 이름 부여 및 엑세스 키 저장

🛑 중요: 엑세스 키와 비밀 엑세스 키는 한 번만 제공되므로 CSV 파일 다운로드 또는 별도로 안전하게 보관해야 한다.

---

3. 📦 AWS S3 버킷 생성

3-1. S3 이동 후 버킷 생성 클릭

3-2. 버킷 이름 설정

3-3. 버킷 설정

⚠️ 실무에서는 모든 퍼블릭 액세스를 차단하는 것이 일반적이지만, 테스트 환경에서는 일부 해제할 수 있다.

---

4. 📝 Spring Boot 설정

4-1. build.gradle에 AWS S3 의존성 추가

// AWS S3
implementation 'com.amazonaws:aws-java-sdk-s3:1.12.510'

4-2. application.yml 설정 추가

aws:
  access-key-id: YOUR_AWS_ACCESS_KEY
  secret-access-key: YOUR_AWS_SECRET_KEY
  s3:
    bucket-name: 버킷 이름
    region: ap-northeast-2

4-3. Amazon S3 설정 클래스

import com.amazonaws.auth.AWSStaticCredentialsProvider;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class AmazonS3Config {
    @Value("${aws.access-key-id}")
    private String awsAccessKey;

    @Value("${aws.secret-access-key}")
    private String awsSecretKey;

    @Value("${aws.s3.region}")
    private String region;

    @Bean
    public AmazonS3 amazonS3() {
        BasicAWSCredentials awsCredentials = new BasicAWSCredentials(awsAccessKey, awsSecretKey);
        return AmazonS3ClientBuilder.standard()
                .withRegion(region)
                .withCredentials(new AWSStaticCredentialsProvider(awsCredentials))
                .build();
    }
}

---

5. 📤 S3 파일 업로드 구현

5-1. Service 클래스 작성

import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.model.ObjectMetadata;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;

@Service
public class S3Service {
    private final AmazonS3 amazonS3;

    @Value("${aws.s3.bucket-name}")
    private String bucketName;

    public S3Service(AmazonS3 amazonS3) {
        this.amazonS3 = amazonS3;
    }

    public String uploadFile(MultipartFile file) {
        String fileName = "uploads/" + System.currentTimeMillis() + "_" + file.getOriginalFilename();

        try {
            ObjectMetadata metadata = new ObjectMetadata();
            metadata.setContentLength(file.getSize());
            metadata.setContentType(file.getContentType());
            
            amazonS3.putObject(bucketName, fileName, file.getInputStream(), metadata);
            return amazonS3.getUrl(bucketName, fileName).toString();
        } catch (IOException e) {
            throw new RuntimeException("파일 업로드에 실패했습니다.", e);
        }
    }
}

5-2. Controller 추가

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

@RestController
@RequestMapping("/files")
public class S3Controller {
    private final S3Service s3Service;

    public S3Controller(S3Service s3Service) {
        this.s3Service = s3Service;
    }

    @PostMapping("/upload")
    public ResponseEntity<String> uploadFile(@RequestParam("file") MultipartFile file) {
        String fileUrl = s3Service.uploadFile(file);
        return ResponseEntity.ok(fileUrl);
    }
}

---

🎉 마무리

이제 Spring Boot에서 AWS S3에 파일을 업로드할 수 있습니다! 🥳
추가적으로 삭제 및 조회 기능을 구현하면 더욱 완벽한 기능을 만들 수 있습니다.