--- title: Runbook — ADAPTER_DISABLED (런타임 어댑터 비활성화 호출) category: INTERNAL error_codes: [ADAPTER_DISABLED] severity: P2 owner: oncall last_updated: 2026-11-07 status: 초안 --- # Runbook: ADAPTER_DISABLED (`runbook://adapter/adapter-disabled`) ## 증상 - HTTP 500, `error.code=ADAPTER_DISABLED`. - 이 배포에서 꺼져 있거나 묶이지 않은 선택 어댑터의 경로를 코드가 호출했다. 지금 템플릿에서 이 코드를 내는 곳은 알림 라우터(`RoutingNotifier`)다. 채널과 route에 묶인 provider가 없을 때 낸다. ## 진단 - ERROR 로그 `failure classified as ADAPTER_DISABLED (category=INTERNAL, retryable=false)`를 찾는다. 줄에 붙은 예외(`AdapterDisabledException`)의 메시지가 어댑터와 고칠 키를 알려 준다. - 기본 메시지: `optional adapter '<이름>' is disabled (app..<이름>.enabled=false) …` - 알림 라우터: `no notification route bound for channel=… route='…' — set app.notification.routes..=…` - 배포 설정에서 어떤 선택 어댑터가 켜져 있는지 본다. ## 조치 - 배포 설정에서 그 어댑터를 켠다(환경 변수 스위치). 알림이면 메시지가 가리키는 route를 묶고 그 provider를 켠다. - 아니면 꺼진 어댑터의 경로를 건너뛰도록 애플리케이션 로직을 고친다. ## 에스컬레이션 - 켜져 있어야 할 어댑터가 꺼져 있으면 배포 담당 팀에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.