📂 첨부파일 다운로드 시 ClassCastException 문제 해결

[Tae4an]

🐞 문제 상황

게시글에 첨부된 파일 다운로드 시 다음과 같은 오류가 발생:

ClassCastException: org.springframework.core.io.UrlResource cannot be cast to com.office.app.dto.PostAttachmentDownloadDTO

📍 발생 위치:

• Endpoint: GET /api/posts/{postId}/attachments/{fileId}/download
• 상황: 게시글에 첨부된 파일 다운로드 시도 중 오류 발생

---

🔍 원인 분석

1️⃣ Service 계층에서 Resource 타입을 직접 반환하려다 타입 캐스팅 문제 발생
2️⃣ 파일 메타데이터(Content-Type, 파일명 등) 누락
3️⃣ Controller와 Service 간 반환 타입 불일치

---

✅ 해결 방법

🏗️ 1. PostAttachmentDownloadDTO 생성

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class PostAttachmentDownloadDTO {
    private Resource resource;
    private String contentType;
    private String originalFileName;
}

🛠️ 2. Service 메서드 수정

public PostAttachmentDownloadDTO downloadAttachment(Long postId, Long fileId, String employeeId) {
    PostAttachment attachment = postAttachmentRepository.findByIdAndPostId(fileId, postId)
        .orElseThrow(() -> new FileNotFoundException("파일을 찾을 수 없습니다."));

    GCSResponse gcsResponse = gcsService.downloadObject(attachment.getStoredFileName(), employeeId);

    return PostAttachmentDownloadDTO.builder()
        .resource(new UrlResource(new URL(gcsResponse.getDownloadUrl())))
        .contentType(attachment.getContentType())
        .originalFileName(attachment.getOriginalFileName())
        .build();
}

🌐 3. Controller 응답 처리 개선

@GetMapping("/{postId}/attachments/{fileId}/download")
public ResponseEntity<Resource> downloadAttachment(
        @PathVariable Long postId,
        @PathVariable Long fileId,
        Authentication authentication) {
    PostAttachmentDownloadDTO downloadInfo = 
        postAttachmentService.downloadAttachment(postId, fileId, authentication.getName());

    return ResponseEntity.ok()
        .contentType(MediaType.parseMediaType(downloadInfo.getContentType()))
        .header(HttpHeaders.CONTENT_DISPOSITION, 
            "attachment; filename=\"" + URLEncoder.encode(downloadInfo.getOriginalFileName(), StandardCharsets.UTF_8) + "\"")
        .body(downloadInfo.getResource());
}

---

✨ 주요 개선사항

• 🎯 DTO를 사용해 데이터 캡슐화
• 📝 Content-Type 및 Content-Disposition 헤더 설정
• 🌏 한글 파일명 처리를 위한 URLEncoder 적용
• 🔄 Service-Controller 간 책임 분리

---

💡 결과

• ✅ 파일 다운로드 기능 정상 작동
• ✅ 한글 파일명 정상 처리
• ✅ 브라우저 다운로드 동작 문제 해결

---

📌 추가 고려사항

🔒 보안 강화: 파일 접근 권한 검증
📈 대용량 파일 처리: 스트리밍 방식 고려

---