📌”FFmpeg 기반 HLS 변환 및 ffprobe 메타데이터 파싱 유틸 개발기”

📅 2025년 4월 27일 / ✍️ by 박찬희

---

🔧 왜 이걸 만들었는가?

JSP 기반 강의 플랫폼에서 드디어 ‘진짜 영상’을 다루게 됐다. 단순 파일 업로드가 아니라, 스트리밍에 적합한 포맷으로 자동 변환하고, 썸네일과 영상 길이까지 추출하는 로직이 필요했다.

물론 직접 플레이어를 컨트롤할 순 없으니, .mp4를 → .m3u8 + .ts로 변환해서 HLS(HTTP Live Streaming) 구조로 전환해야 했다. 여기에 ffmpeg, ffprobe를 연동한 순수 Java 유틸리티를 만드는 게 이번 목표였다.

---

🎯 구현 목표

1. 강의 등록 시 .mp4 파일을 HLS 스트리밍용 .m3u8 포맷으로 자동 변환
2. DB에 저장할 영상 길이 (초 단위)도 자동 추출
3. 향후 AWS S3나 CDN 확장까지 고려해 경로 설계, 예외 처리, 로깅 구조를 잘 정리해둘 것

---

🧩 핵심 구현 요약

1. FFmpeg를 활용한 mp4 → HLS 변환

public static String convertToHLS(File inputFile, String uuid, String outputDir)

• ffmpeg.exe를 ProcessBuilder로 직접 실행
• hls_time 10: 10초 단위로 ts 세그먼트 분할
• 실행 후 /upload/hls/{uuid}.m3u8 경로 반환 (JSP에서 접근용)

ffmpeg -i input.mp4 -c:v libx264 -c:a aac -hls_time 10 -f hls output.m3u8

📌 주의: FFmpeg는 공백 포함된 경로에 민감하다. → .replace("\\", "/") 필수 적용

---

2. 영상 길이 추출 (ffprobe)

public static int getVideoDurationInSeconds(File videoFile)

• ffprobe를 통해 별도 디코딩 없이 메타데이터만 분석
• 출력: "122.45" → Double.parseDouble() → Math.round() → int 변환

ffmpeg에 비해 훨씬 빠르고 가볍다. 실시간 처리를 염두에 두면 ffprobe는 필수 툴이다.

---

📦 구조 설계 포인트

항목	고려 사항
🎯 순수 유틸화	FFmpegUtil은 JSP/컨트롤러에 전혀 의존하지 않도록 설계
🧱 예외 흐름	IOException, InterruptedException, NumberFormatException 모두 로깅 처리
🧩 실행 경로 분리	ffmpeg.exe, ffprobe.exe 경로는 상수로 관리해 OS 이식성 확보
🔍 로깅 구조	java.util.logging.Logger 기반 stdout/stderr 로깅 → 추후 log4j, slf4j 대응 가능
🔗 경로 추상화	실제 저장경로(C:/lecture_uploads/hls/...) ↔ JSP 접근경로(/upload/hls/...) 분리
🔧 프로세스 제어	ProcessBuilder로 실행 + exitCode 체크로 안정성 확보

---

🧨 디버깅 이슈: ffmpeg 실패 (exitCode=1)

문제:

• 변환이 안 되고 exitCode=1만 리턴됨
• 로그를 보니 경로 문제였음 (공백/역슬래시 이슈)

해결:

String safePath = file.getAbsolutePath().replace("\\", "/");

• Windows 경로 문제 우회
• ProcessBuilder 인자는 공백 포함 경로일 경우 반드시 분리하거나 전체 문자열로 처리해야 안전

---

🌱 확장 고려사항

확장 요소	설계 방향
☁️ AWS S3 업로드	uploadDir를 S3 버킷 URL로 변경하면 바로 대응 가능
🎞 썸네일 자동화	extractThumbnail() 함수로 프레임 캡처 확장 예정
🔐 스트리밍 보안	.m3u8, .ts 요청에 JWT 기반 접근 제한 로직 적용 가능
⚙️ 비동기 처리	현재는 동기 처리 → 추후 ExecutorService 또는 MQ 기반 비동기로 전환 검토 필요

---

🔁 실제 흐름

1. LectureUploadController에서 사용자가 업로드한 파일을 저장
2. 저장된 File을 convertToHLS()로 변환
3. getVideoDurationInSeconds()로 길이 추출
4. DTO에 정보 세팅:

videoPath = "/upload/hls/{uuid}.m3u8";
duration = 125;
thumbnailPath = "/upload/thumb/{uuid}.jpg";

---

🚀 최종 성과

• <video src="/upload/hls/xxx.m3u8"> 형태로 스트리밍 완벽 구현
• JSP에서는 단순 경로만 알면 되고, 실제 파일 구조는 외부에 숨겨짐
• 전체 로직은 순수 Java 유틸리티로 구성되어 재사용성과 이식성이 높음

---

✍️ 회고 & 배운 점

이번 작업을 하며 크게 3가지를 느꼈다:

1. ffmpeg와 ffprobe는 단순한 CLI 툴이 아니다.
   • 복잡한 백엔드 시스템에서 정밀하게 제어 가능한 영상 처리 도구다.
2. Java에서 외부 프로세스를 실행할 때는 OS 경로 호환성에 민감해야 한다.
   • 특히 Windows에서 \ → / 변환과 공백 이슈는 반드시 선처리해야 함.
3. 순수 유틸리티는 설계의 미덕이다.
   • JSP나 Spring과 결합되지 않은 독립 유틸로 구현하니, 테스트도 편하고 확장도 자유롭다.