이미지 파일 업로드 시 회전 버그 해결

build.gradle

@@ -95,6 +95,11 @@ dependencies {
     implementation 'com.navercorp.lucy:lucy-xss:1.6.3' // Lucy XSS Filter
     implementation 'org.apache.commons:commons-text:1.11.0' // Apache Commons Text
 
+    // Image
+    implementation 'commons-io:commons-io:2.8.0'
+    implementation 'com.drewnoakes:metadata-extractor:2.14.0'
+    implementation 'org.imgscalr:imgscalr-lib:4.2'
+
     // Test
     testImplementation 'org.springframework.boot:spring-boot-starter-test' // Spring Boot Test
     testImplementation 'org.springframework.security:spring-security-test' // Spring Security Test

src/main/java/page/clab/api/global/common/file/application/FileHandler.java

@@ -1,9 +1,18 @@
 package page.clab.api.global.common.file.application;
 
+import com.drew.imaging.ImageMetadataReader;
+import com.drew.imaging.ImageProcessingException;
+import com.drew.metadata.Directory;
+import com.drew.metadata.Metadata;
+import com.drew.metadata.MetadataException;
+import com.drew.metadata.exif.ExifIFD0Directory;
 import com.google.common.base.Strings;
+import java.io.FileOutputStream;
+import java.io.InputStream;
 import javax.imageio.ImageIO;
 import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.io.FilenameUtils;
+import org.imgscalr.Scalr;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.stereotype.Component;
@@ -68,11 +77,75 @@ public String saveFile(MultipartFile multipartFile, String category) throws IOEx
 
         File file = new File(savePath);
         ensureParentDirectoryExists(file);
-        multipartFile.transferTo(file);
+
+        try {
+            if (isImageFile(multipartFile)) {
+                BufferedImage originalImage = adjustImageDirection(multipartFile);
+                ImageIO.write(originalImage, extension, file);
+            }
+            else {
+                multipartFile.transferTo(file);
+            }
+        } catch (Exception e) {
+            throw new IOException("이미지의 뱡향을 조정하는데 오류가 발생했습니다.", e);
+        }
+
         setFilePermissions(file, savePath, extension);
         return savePath;
     }
 
+    private BufferedImage adjustImageDirection(MultipartFile multipartFile) throws Exception {
+        File tempFile = File.createTempFile("temp", null);
+        multipartFile.transferTo(tempFile);
+        int originalDirection = getImageDirection(tempFile);
+        BufferedImage bufferedImage = ImageIO.read(tempFile);
+
+        switch (originalDirection) {
+            case 1:
+                break;
+            case 3:
+                bufferedImage = Scalr.rotate(bufferedImage, Scalr.Rotation.CW_180, null);
+                break;
+            case 6:
+                bufferedImage = Scalr.rotate(bufferedImage, Scalr.Rotation.CW_90, null);
+                break;
+            case 8:
+                bufferedImage = Scalr.rotate(bufferedImage, Scalr.Rotation.CW_270, null);
+                break;
+        }
+
+        if (tempFile.exists() && !tempFile.delete()) {
+            throw new IOException("Failed to delete image file: " + tempFile.getAbsolutePath());
+        }
+
+        return bufferedImage;
+    }
+
+    public int getImageDirection(File tempFile) {
+        int originalDirection = 1;
+        try {
+            Metadata metadata = ImageMetadataReader.readMetadata(tempFile);
+            Directory directory = metadata.getFirstDirectoryOfType(ExifIFD0Directory.class);
+            if (directory != null) {
+                originalDirection = directory.getInt(ExifIFD0Directory.TAG_ORIENTATION);
+            }
+        } catch (IOException e) {
+            log.error("이미지 파일을 읽는 중 IO 오류 발생: {}", e.getMessage());
+        } catch (ImageProcessingException e) {
+            log.error("이미지 파일 처리 중 오류 발생: {}", e.getMessage());
+        } catch (MetadataException e) {
+            log.error("이미지 파일의 메타데이터를 읽는 중 오류 발생: {}", e.getMessage());
+        } catch (Exception e) {
+            log.error("예기치 않은 오류 발생: {}", e.getMessage());
+        }
+        return originalDirection;
+    }
+
+    private boolean isImageFile(MultipartFile file) {
+        String contentType = file.getContentType();
+        return contentType != null && contentType.startsWith("image/");
+    }
+
     private void validateFileAttributes(String originalFilename, String extension) throws FileUploadFailException {
         if (!validateFilename(originalFilename)) {
             throw new FileUploadFailException("허용되지 않은 파일명 : " + originalFilename);

src/main/java/page/clab/api/global/config/WebConfig.java

@@ -1,6 +1,7 @@
 package page.clab.api.global.config;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
+import java.io.File;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;

src/main/java/page/clab/api/global/handler/GlobalExceptionHandler.java

@@ -1,5 +1,7 @@
 package page.clab.api.global.handler;
 
+import com.drew.imaging.ImageProcessingException;
+import com.drew.metadata.MetadataException;
 import com.google.gson.stream.MalformedJsonException;
 import jakarta.mail.MessagingException;
 import jakarta.servlet.http.HttpServletRequest;
@@ -192,6 +194,8 @@ public ErrorResponse conflictException(HttpServletResponse response, Exception e
             EncryptionException.class,
             DecryptionException.class,
             InvalidDataAccessApiUsageException.class,
+            ImageProcessingException.class,
+            MetadataException.class,
             Exception.class
     })
     public ApiResponse serverException(HttpServletRequest request, HttpServletResponse response, Exception e) {