ivada-infra/DOCS

Fork 0

happybell80 e6fc2a60da ✅ rb8001 레벨 표시 문제 해결 완료 - 레벨 20 정상 표시

2025-08-28 16:41:33 +09:00

5.6 KiB

Raw Blame History

rb8001 레벨 1 표시 문제 해결

작성일: 2025-08-23 (수정: 2025-08-28)

작성자: happybell80 with Claude

상태: ✅ 해결 완료

1. 문제 상황

증상

DB에 rb8001의 레벨이 20으로 저장되어 있음
프론트엔드에서는 계속 레벨 1로 표시됨
/api/stats/rb8001 요청시 기본값(레벨 1) 반환

영향

사용자가 로빙의 실제 성장 상태를 확인할 수 없음
Gmail 아이템 등 레벨 기반 기능 사용 제한

2. 원인 분석

2.1 Gateway의 하드코딩 문제

위치: robeing-gateway/app/main.py:267

# 문제 코드
response = await http_client.get(
    f"http://192.168.219.52:10508/api/stats/{robeing_id}"  # 항상 rb10508_micro로!
)

문제점:

모든 stats 요청을 rb10508_micro(포트 10508)로 강제 라우팅
사용자별 로빙 무시

2.2 프론트엔드 헤더 누락

위치: frontend-customer/src/services/robeing-api.ts:447

// 문제 코드
const response = await fetch(`${ROBEING_API_URL}/api/stats/${robeingId}`);
// X-User-Id 헤더 없음!

문제점:

Gateway가 사용자를 식별할 수 없음
기본값 반환

2.3 잘못된 엔드포인트 경로

실제 엔드포인트:

rb8001: /stats (api 없음)
rb10508_micro: /stats/{robeing_id} (api 없음)

Gateway 요청:

/api/stats/{robeing_id} → 404 에러

2.4 서버 위치 오류

Gateway 설정:

rb8001: http://localhost:8001 → 51123 서버에 없음

실제 위치:

rb8001: http://192.168.219.52:8001 (51124 서버)

2.5 State Service 연결 실패 (제거됨 - State Service 사용 안 함)

~~State Service는 더 이상 사용하지 않음~~
rb8001이 직접 DB 접근하여 스탯 조회

3. 해결 과정

3.1 Gateway 사용자별 라우팅 구현

# robeing-gateway/app/main.py
@app.get("/api/stats/{robeing_id}")
async def get_stats(
    robeing_id: str,
    x_user_id: Optional[str] = Header(None)  # 사용자 식별 추가
):
    # 사용자별 로빙 정보 조회
    robeing_info = await get_robeing_info(x_user_id)
    
    # 로빙별 올바른 서버로 라우팅
    if robeing_id == "rb8001":
        target_url = f"http://192.168.219.52:8001/stats"
    elif robeing_id == "rb10508_micro":
        target_url = f"http://192.168.219.52:10508/stats/{robeing_id}"

3.2 프론트엔드 헤더 추가

// frontend-customer/src/services/robeing-api.ts
const headers: HeadersInit = {
    'X-User-Id': userId,
    'Authorization': `Bearer ${authToken}`
};

const response = await fetch(`${ROBEING_API_URL}/api/stats/${robeingId}`, {
    headers
});

3.3 응답 형식 정규화

# rb8001 응답 형식 변환
if robeing_id == "rb8001" and "stats" in data:
    return {
        "robeing_id": robeing_id,
        "level": data.get("level", 1),
        "experience": stats_data.get("experience", 0),
        # ... 표준 형식으로 변환
    }

4. 해결 진행 (2025-08-28)

4.1 완료된 작업 ✅

robeing-monitor: state_service를 /api 경로로 마운트

Gateway: 모든 로빙을 robeing-monitor로 통합

# 조건문 제거, 모든 로빙 통합
target_url = f"http://192.168.219.52:9024/api/stats/{robeing_id}"

DB: robeing_stats에 스탯 컬럼 추가 (memory, compute 등)
테스트: robeing-monitor 직접 호출 시 레벨 20 반환 확인

4.2 새로운 문제 발견 및 해결 완료 ✅

robeing_id가 undefined로 전달됨

Gateway 로그:
GET /api/stats/undefined HTTP/1.0" 200 OK
GET /api/user/robeing → 404 Not Found

원인: Frontend가 잘못된 엔드포인트 호출

시도: /api/user/robeing (없음)
실제: /api/robeing/info (Gateway에 있음)

해결 완료 (로컬 개발자):

Gateway: /api/robeing/info JWT 인증 적용 ✅

x_user_id: str = Depends(get_verified_user)

Frontend: 엔드포인트 변경 ✅

// 변경 전: /api/user/robeing
// 변경 후: /api/robeing/info

4.3 라우트 우선순위 문제 (2025-08-28 추가)

문제 발견: /api/robeing/info가 작동 안함

GET http://192.168.219.52:8001/api/robeing/info → 404 Not Found

원인: FastAPI 라우트 정의 순서

/api/{path:path} (line 408) - catch-all 패턴이 먼저 매칭
/api/robeing/info (line 431) - 도달하지 못함
결과: robeing/info가 rb8001로 프록시되어 404

해결 필요:

/api/robeing/info를 /api/{path:path}보다 앞에 정의
또는 catch-all 패턴에서 robeing/info 제외

4.4 최종 플로우 ✅ 해결 완료

Frontend (JWT) → Gateway /api/stats/rb8001 → robeing-monitor → DB
                              ↓
                    레벨 20 정상 반환 및 표시

해결 완료 (2025-08-28 16:40):

Frontend가 레벨 20 정상 표시
DB 값이 UI에 올바르게 반영됨

5. 교훈

아키텍처 일관성

모든 로빙이 동일한 API 경로 규칙을 따라야 함
/api/stats vs /stats 혼용 문제

헤더 전달 중요성

프론트엔드는 항상 사용자 식별 헤더 포함 필요
X-User-Id, Authorization 등

환경변수 관리

필수 서비스 URL은 반드시 설정
누락시 fallback 처리 필요

디버깅 체인

프론트엔드 요청 확인
Gateway 라우팅 확인
실제 서비스 엔드포인트 확인
서비스 내부 로직 확인

6. 참고 파일

robeing-gateway/app/main.py
frontend-customer/src/services/robeing-api.ts
rb8001/main.py
rb8001/app/router/router.py
rb8001/docker-compose.yml

5.6 KiB Raw Blame History