자주 묻는 질문
이 장에서는 Antigravity Tools 사용 과정에서 가장 자주 만나는 오류 코드와 예외 시나리오를 수집하여 문제의 근본 원인을 빠르게 찾아내고 해결 방안을 찾도록 도와드립니다.
이 장 포함 내용
| 문제 유형 | 페이지 | 설명 |
|---|---|---|
| 계정 비활성화 | invalid_grant 및 계정 자동 비활성화 | 계정이 갑자기 사용할 수 없게 됨? OAuth Token 실패 원인과 복구 절차 이해 |
| 인증 실패 | 401/인증 실패 | 요청이 거부됨? auth_mode 구성 및 Header 형식 확인 |
| 속도 제한 오류 | 429/용량 오류 | 잦은 429? 할당량 부족과 상류 속도 제한 구분, 로테이션 전략으로 영향 줄이기 |
| 경로 오류 | 404/경로 호환성 | 인터페이스 404? Base URL 및 /v1 접두사 연결 문제 해결 |
| 스트리밍 예외 | 스트리밍 중단/0 Token/서명 무효 | 응답 중단 또는 비어 있음? 프록시의 자가 치유 메커니즘 및 문제 해결 경로 이해 |
학습 경로 추천
오류 코드별 문제 해결: 특정 오류가 발생하면 해당 페이지로 직접 이동하세요.
체계적 학습: 가능한 모든 문제를 완전히 이해하려면 다음 순서로 읽으시는 것을 추천합니다:
- 404/경로 호환성 — 가장 일반적인 연결 문제, 보통 첫 번째 함정
- 401/인증 실패 — 경로가 올바르지만 요청이 거부됨, 인증 구성 확인
- invalid_grant 및 계정 자동 비활성화 — 계정 수준 문제
- 429/용량 오류 — 요청 성공하지만 속도 제한됨
- 스트리밍 중단/0 Token/서명 무효 — 고급 문제, 스트리밍 응답 및 서명 메커니즘 포함
전제 조건
먼저 완료할 것
- 로컬 리버스 프록시 시작 및 첫 클라이언트 연결 — 기본 환경이 실행 중인지 확인
- 계정 추가 — 계정 추가 올바른 방법 이해
다음 단계
문제 해결 후 심층 학습을 계속할 수 있습니다:
- 고가용성 스케줄링 — 로테이션 및 재시도 전략으로 오류 발생 감소
- Proxy Monitor — 로그 시스템으로 요청 세부 정보 추적
- 구성 완전 해설 — 모든 구성 항목의 역할 이해