파워토이 키보드 매니저 서비스 다운 오류 해결방법

PowerToys 키보드 매니저를 열었더니 서비스 오류 메시지만 뜨고, 다시 매핑이 작동하지도 않고 항목을 편집할 수도 없는 상태가 됐습니다. 재시작해도 그대로라면, 설정 파일이 손상됐을 가능성이 큽니다.

이 글을 읽고 나면, 엔진 로그에서 원인을 확인하고 설정 파일을 초기화해 키보드 매니저를 복구하는 방법을 알 수 있습니다.

어떤 오류인가

키보드 매니저 설정 화면에 아래 메시지가 뜨고, 다시 매핑이 전부 멈춥니다. 항목 편집도 안 됩니다.

Keyboard Manager 서비스가 다운되있습니다. 서비스가 복원될 때까지 다시 매핑이 작동하지 않으며 항목을 편집할 수 없습니다.

PowerToys를 껐다 켜도 메시지가 그대로라면, 단순한 일시 오류가 아닙니다. 키보드 매니저 엔진이 시작할 때 설정 파일을 읽지 못하고 있다는 신호입니다.

원인 확인: 엔진 로그

원인은 키보드 매니저 엔진 로그에서 확인할 수 있습니다. 로그 경로는 사용자명과 PowerToys 버전에 따라 다릅니다.

C:\Users\사용자명\AppData\Local\Microsoft\PowerToys\Keyboard Manager\Engine\Logs\버전폴더

버전 폴더 안에 날짜별 로그 파일이 있습니다. 가장 최근 로그 파일을 열어보면, 아래 같은 오류가 찍혀 있습니다.

[2026-11-12 14:58:01.131854] [p-19348] [t-19352] [error] Improper JSON format for shortcut remaps. Skip to next remap type
[2026-11-12 14:58:01.132007] [p-19348] [t-19352] [error] Improper JSON format for single key to text remaps. Skip to next remap type

단축키 다시 매핑과 단일 키 다시 매핑의 JSON 형식이 잘못됐다는 오류입니다. 엔진이 설정 파일을 해석하지 못해 다음 단계로 건너뛰고, 결국 서비스가 다운된 상태로 남는 것입니다.

원인 추정: 설정 파일 손상

단축키 매핑은 default.json 파일에 저장됩니다. 이 파일이 손상됐거나 형식이 맞지 않으면 엔진이 읽지 못하고, 키보드 매니저 전체가 멈춥니다.

파일 경로는 아래와 같습니다.

C:\Users\사용자명\AppData\Local\Microsoft\PowerToys\Keyboard Manager\default.json

공식 개발 문서에서도 키보드 매니저의 다시 매핑 프로필 형식이 default.json이라고 설명하고 있습니다. 즉, 이 파일 하나가 모든 다시 매핑 설정을 들고 있는 셈입니다.

해결 방법: default.json 초기화

해결 방법은 default.json을 초기화하는 것입니다. 파일이 없는 상태로 PowerToys를 시작하면, 키보드 매니저가 새 설정 파일을 만들어 오류가 사라집니다.

순서는 이렇습니다.

• PowerToys를 완전히 종료합니다. 트레이 아이콘에서 종료하거나 작업 관리자에서 PowerToys 프로세스를 끝냅니다.
• 탐색기에서 default.json이 있는 폴더를 엽니다.
• 중요한 매핑이 없다면 default.json을 삭제합니다. 중요한 매핑이 있다면 파일을 삭제하지 말고 이름을 default.json.bak처럼 바꿔 백업해둡니다.
• PowerToys를 다시 시작합니다. 키보드 매니저가 새 default.json을 만들고, 오류 메시지가 사라집니다.

정리

키보드 매니저에 서비스 오류가 뜨고 다시 매핑이 멈췄다면, 엔진 로그부터 확인해보세요. JSON 형식 오류가 찍혀 있다면 default.json이 손상된 것이고, 파일을 초기화한 뒤 PowerToys를 다시 시작하면 복구됩니다. 다시 매핑은 새로 만들면 되니, 오류 메시지에 너무 오래 붙잡혀 있지 마세요.

써보면서 막히는 부분이 있으면 댓글로 남겨주세요!