# 문제 해결

> Xisom Edge AI Box의 일반적인 문제를 진단하고 해결하기 위한 증상 중심 런북입니다.

표에서 증상을 찾아 해당 해결 방법으로 이동하세요. 모든 런북 페이지는 동일한 구조를
따릅니다: **증상 → 확인 → 해결 → 예방**.

## 증상 찾기

| 다음과 같은 현상이 보이면… | 이동 |
|---|---|
| GPU가 설치되어 있으나 추론이 CPU에서 실행됨; 로그에 `CUDA failure 500: named symbol not found` 표시 | [GPU 미사용 — CUDA 오류 500](/ko/troubleshooting/gpu-cuda-error-500/) |
| GPU 강제 적용 시 호스트 GPU가 손상되어 추론 컨테이너가 종료/재시작됨 | [GPU 미사용 — CUDA 오류 500](/ko/troubleshooting/gpu-cuda-error-500/) |
| 호스트 GPU는 동작하나 공급자가 예상보다 낮은 등급으로 표시됨 (예: TensorRT 대신 CUDA, 또는 CPU) | [GPU 예상 시 CPU에서 실행됨](/ko/troubleshooting/execution-provider-fallback/) |
| 로그 줄 `Failed to load library libonnxruntime_providers_tensorrt.so` | [GPU 예상 시 CPU에서 실행됨](/ko/troubleshooting/execution-provider-fallback/) |
| 데이터소스 활성화가 `model_not_paired` 또는 `adapter_connect_failed`와 함께 다시 비활성화로 되돌아감 | [데이터소스 다운 또는 장애](/ko/troubleshooting/datasource-down-or-faulted/) |
| 스트리밍 OPC-UA / MQTT / CSV 소스가 멈춤; 행에 장애 표시 / 빨간 배너가 나타남 | [데이터소스 다운 또는 장애](/ko/troubleshooting/datasource-down-or-faulted/) |
| 데이터소스가 활성화되었으나 예측값이 나타나지 않음 | [데이터소스 다운 또는 장애](/ko/troubleshooting/datasource-down-or-faulted/) |
| **설정 → 정보**에서 프런트엔드 / 백엔드 버전이 호박색으로 강조됨 | [프런트엔드 / 백엔드 버전 불일치](/ko/troubleshooting/version-drift-fe-be/) |
| 버전이 `0.0.0-dev…`로 표시되거나 `-dirty`로 끝남 | [프런트엔드 / 백엔드 버전 불일치](/ko/troubleshooting/version-drift-fe-be/) |
| 디스크가 가득 참; 데이터베이스 파일이 보유 데이터보다 훨씬 큼; 행을 삭제해도 줄어들지 않음 | [디스크 가득 참 / 데이터베이스 무한 증가](/ko/troubleshooting/sqlite-retention-disk/) |
| `docker ps`에서 컨테이너가 `unhealthy`로 표시되나 앱은 정상 동작함 | [컨테이너가 unhealthy로 표시되나 서비스는 정상](/ko/troubleshooting/healthcheck-ipv6-false-negative/) |

배포된 스택은 릴리스 compose 파일을 사용합니다. 이 페이지들의 명령은 실행 중인
컨테이너(`aiboard-inference-real`, `aiboard-backend-real`,
`aiboard-frontend-real`)에 대해 `docker compose -f docker-compose.release.yml …`로
작성되었습니다.