---
title: "우분투 Failed to load module xapp-gtk3-module 해결 | DeviceTests"
description: "우분투 22.04, 24.04, 26.04에서 \"Failed to load module xapp-gtk3-module\" 메시지가 뜨나요? XApp 패키지를 설치하거나 세션이 모듈을 찾지 않게 하세요."
url: https://devicetests.com/ko/xapp-gtk3-module-%EC%98%A4%EB%A5%98-%ED%95%B4%EA%B2%B0
language: ko
---

# 우분투 20.04 "Failed to load module xapp-gtk3-module" 오류 해결 방법

글 Brent Cohen · 2026년 11월 4일 업데이트 · 2023년 7월 22일 최초 게시

한 줄 답변

GTK3 앱이 Linux Mint의 XApp 모듈을 불러오려는데, 모듈이 설치되어 있지 않다는 메시지예요. 경고일 뿐이라 앱은 그대로 작동해요. 메시지를 없애려면 모듈이 들어 있는 패키지를 설치하거나, 세션이 모듈을 찾지 않게 하세요.

모듈은 `GTK3_MODULES` 설정으로 불러와요. XApp이나 Cinnamon 패키지를 설치했거나 설치한 적이 있으면 로그인 스크립트가 이 값을 지정해요. 모듈 자체가 없으면 터미널에서 실행한 GTK3 앱이 이 메시지를 출력해요.

## 해결 1: 모듈 설치하기

패키지 이름은 우분투 버전마다 달라요.

### 우분투 22.04

```
sudo apt update
sudo apt install xapp
```

이미 설치되어 있다면 다시 설치하세요.

```
sudo apt install --reinstall xapp libxapp1 gir1.2-xapp-1.0 xapps-common
```

### 우분투 24.04, 26.04

여기에는 `xapp` 패키지가 없어요. 모듈은 `libxapp-gtk3-module`에 들어 있어요.

```
sudo apt update
sudo apt install libxapp-gtk3-module
```

이미 설치되어 있다면 다시 설치하세요.

```
sudo apt install --reinstall libxapp-gtk3-module libxapp1 gir1.2-xapp-1.0 xapps-common
```

앱을 닫았다가 다시 여세요. 메시지가 사라질 거예요.

> 우분투 20.04라면
>
> 우분투 20.04의 XApp에는 GTK3 모듈이 없어서 `sudo apt install xapp`이 실패해요. Mint나 Cinnamon 패키지를 다른 곳에서 설치했을 때만 이 메시지가 떠요. 해결 2를 쓰세요. 20.04는 표준 지원이 끝났으니 업그레이드하는 편이 장기적으로 더 좋아요.

## 해결 2: 세션이 모듈을 찾지 않게 하기

Cinnamon이나 Mint 앱을 쓰지 않을 때 사용하세요.

1. 아래 명령을 실행해 어떤 설정에서 모듈을 불러오는지 확인하세요.

   ```
   echo "$GTK3_MODULES $GTK_MODULES"
   grep -rs xapp /etc/X11/Xsession.d/ ~/.profile ~/.xsessionrc ~/.bashrc
   ```

2. 아래 명령으로 현재 터미널에서 먼저 시험해 보세요. 그다음 같은 터미널에서 앱을 실행하세요.

   ```
   unset GTK_MODULES GTK3_MODULES
   ```

3. 메시지가 사라지면 1단계에서 찾은 설정에서 `xapp-gtk3-module` 항목을 지우세요.

우분투 24.04와 26.04에서는 로그인 스크립트가 `/etc/X11/Xsession.d/80xapp-gtk3-module`이에요. 패키지를 purge 없이 지우면 이 파일이 남아요. 아래 명령으로 패키지와 남은 설정 파일을 함께 지운 뒤 로그아웃했다가 다시 로그인하세요.

```
sudo apt purge libxapp-gtk3-module
```

## 해결 3: 그냥 두기

이 메시지는 앱을 멈추지 않아요. 모든 게 잘 작동하면 그냥 둬도 돼요.

## 자주 묻는 질문

**"Failed to load module 'xapp-gtk3-module'" 메시지는 무시해도 되나요?**

네. 오류가 아니라 안내 메시지예요. 모듈이 없어도 앱은 실행되고, XApp의 작은 기능 몇 가지만 빠져요.

## 출처

- [Linux Mint: XApp 소스 코드와 변경 기록 (2.0.6부터 GTK3_MODULES 사용)](https://github.com/linuxmint/xapp)
- [우분투 패키지: 22.04에서 해당 모듈이 들어 있는 xapp](https://packages.ubuntu.com/jammy/amd64/xapp/filelist)
- [우분투 패키지: 24.04의 libxapp-gtk3-module](https://packages.ubuntu.com/noble/amd64/libxapp-gtk3-module/filelist)
- [Launchpad: 우분투의 xapp 패키지(20.04에는 GTK3 모듈 없음, 26.04 패키지 버전)](https://launchpad.net/ubuntu/+source/xapp)
- [GTK 3: GTK 앱 실행하기 (GTK_MODULES, GTK3_MODULES)](https://docs.gtk.org/gtk3/running.html)

## 직접 테스트해 보세요

무료 테스트로 내 기기를 확인해 보세요. 웹 브라우저에서 바로 실행돼요.

- [내 기기 정보](https://devicetests.com/ko/%EB%82%B4-%EA%B8%B0%EA%B8%B0-%EC%A0%95%EB%B3%B4): 시스템, 브라우저, 화면, 그래픽, 메모리를 쉬운 말로 보고 하나의 보고서로 복사하세요.
- [프린터 테스트 페이지](https://devicetests.com/ko/%ED%94%84%EB%A6%B0%ED%84%B0-%ED%85%8C%EC%8A%A4%ED%8A%B8): 컬러, 흑백, 회색, 정렬 페이지를 인쇄하거나 PDF로 저장하고 결과를 읽어 보세요.
- [그래픽카드 테스트](https://devicetests.com/ko/%EA%B7%B8%EB%9E%98%ED%94%BD%EC%B9%B4%EB%93%9C-%ED%85%8C%EC%8A%A4%ED%8A%B8): 브라우저가 쓰는 그래픽 칩, 지원하는 기능, 그리기 속도를 확인하세요.
