# Task: Debugging File Upload Error (Persistent 500)

> **일시**: 2026-02-15 16:10
> **상태**: 🟢 완료 (Completed)

## 작업 내역
*   [x] 분석: 오류 로그 및 스크린샷 기반 원인 분석 (`/api/upload`) - 서비스 계정 할당량 문제(0 bytes) 확인.
*   [x] 조사: `GOOGLE_DRIVE_FOLDER_ID` 환경 변수 설정 상태 확인 (등록 완료).
*   [x] 수정: 서버 사이드 에러 로깅 강화 (Stack trace, Error code 추가).
*   [x] 수정: 클라이언트 사이드 에러 핸들링 강화 (상세 메시지 Alert 표시).
*   [x] 구현: **OAuth2 인증 방식 추가** (개인 계정 할당량 문제 해결용).
*   [x] 트러블슈팅: `invalid_grant`, `unauthorized_client` 에러 해결 (Playground '내 설정' 적용 및 앱 게시 안내).
*   [x] 문서: OAuth2 설정 가이드 작성 및 사용자 매뉴얼 업데이트.
*   [x] 검증: 사용자가 OAuth2 환경 변수 설정 후 업로드 성공 확인.

## 결과
- 이제 개인 구글 계정의 저장 공간을 활용하여 문성 파일 업로드가 정상적으로 작동함.
- 향후 드라이브 설정 변경 시 `docs/specs/260215-16.10-google-drive-oauth2-setup.md` 참고 가능.
