Unity UI 버튼이 새 Input System에서 클릭되지 않을 때 해결 방법

 

ChatGPT 생성 이미지

새 Input System으로 바꾼 뒤 UI 버튼이 안 눌리는 이유

혹시 Input System 패키지를 설치하고 나서 멀쩡하던 버튼이 갑자기 안 눌린 적 있으세요?

캐릭터는 잘 움직이는데 메뉴 버튼만 꿈쩍도 안 하면 정말 당황스럽죠.
Input System은 Unity가 공식 패키지로 제공하는 새 입력 시스템이에요.

그런데 UI 클릭은 캐릭터 이동 입력과 다른 길로 전달돼요. 그래서 입력 방식을 바꾸면 UI 쪽 연결만 따로 끊기는 경우가 많아요.

버전마다 메뉴 이름이 조금 달라도 확인 순서는 같으니 걱정하지 않으셔도 돼요.


결론 먼저 말씀드리겠습니다.

1. 왼쪽 [Hierarchy] 창에서 EventSystem을 선택하고 오른쪽 [Inspector]를 봐요.

Standalone Input Module이 붙어 있다면 Inspector에 나타나는 교체 버튼을 눌러 Input System UI Input Module로 바꿔요.

2. EventSystem이 아예 없다면 상단 메뉴 [GameObject] → [UI] → [Event System]으로 추가해요.

3. 그래도 안 눌리면 Canvas의 Graphic Raycaster, 버튼을 덮은 Image의 Raycast Target, Button의 Interactable을 차례로 확인해요.


버튼 클릭이 전달되는 4단계

이 섹션에서는 마우스 클릭이 버튼까지 도착하는 경로를 네 단계로 나눠서 볼게요. 어느 단계에서 끊겼는지 알면 고칠 곳도 바로 보여요.

EventSystem(이벤트 시스템): 클릭을 배달하는 우체국

UI가 반응하려면 클릭을 받아서 알맞은 버튼에 전달해 줄 담당자가 먼저 있어야 해요.
EventSystem은 씬 안에서 UI 입력을 관리하는 오브젝트예요.

쉽게 말하면 "클릭이라는 편지를 버튼에 배달하는 우체국"이에요.
우체국이 없으면 편지를 아무리 보내도 버튼에 도착하지 않아요.

보통 Canvas를 처음 만들 때 함께 생성되지만, 씬을 복사하거나 프리팹만 옮기면 빠지는 경우가 있어요. 왼쪽 [Hierarchy] 창에서 "EventSystem"이라는 이름의 오브젝트가 있는지 먼저 확인해요.


UI 입력 모듈(Input Module): 입력 방식에 맞는 통역사

EventSystem 오브젝트에는 입력을 읽어 오는 모듈 컴포넌트가 함께 붙어 있어요.

예전 방식(Input Manager)용은 Standalone Input Module이고, 새 Input System용은 Input System UI Input Module이에요.

모듈은 "입력 장치의 말을 UI에게 통역해 주는 통역사"라고 생각하면 쉬워요.
옛날 말만 아는 통역사를 그대로 두고 프로젝트 입력을 새 방식으로만 바꾸면, 통역사가 아무것도 못 알아듣게 돼요.

이 설정은 상단 메뉴 [Edit] → [Project Settings] → 왼쪽 목록 [Player] → [Other Settings]의 [Active Input Handling] 항목에서 확인할 수 있어요.

이 항목이 Input System Package로 되어 있다면 모듈도 반드시 Input System UI Input Module이어야 해요.


Graphic Raycaster(그래픽 레이캐스터): 어떤 버튼을 눌렀는지 찾는 레이저

모듈이 클릭을 읽었다면, 이제 화면의 어느 UI를 눌렀는지 찾아야 해요. Raycast(레이캐스트)는 클릭한 지점에서 쏘는 "보이지 않는 레이저"예요. Canvas에 붙은 Graphic Raycaster 컴포넌트가 이 레이저를 쏴서 맞은 UI를 찾아요. 이 컴포넌트가 없거나 꺼져 있으면 클릭 위치에 버튼이 있어도 찾지 못해요. [Hierarchy]에서 Canvas를 선택한 뒤 [Inspector] 아래쪽에 Graphic Raycaster가 있고 체크되어 있는지 확인해요.


Raycast Target과 Interactable: 클릭을 막는 투명한 벽

레이저가 버튼보다 먼저 다른 UI에 맞으면 클릭은 그 UI가 가져가요
Image나 Text 컴포넌트의 Raycast Target 옵션이 켜져 있으면 그 UI가 레이저를 받는 대상이 돼요. 

버튼 위에 투명한 배경 이미지나 넓은 텍스트 상자가 겹쳐 있으면 "보이지 않는 유리벽"이 버튼을 가리고 있는 셈이에요. 또 Button 컴포넌트의 Interactable이 꺼져 있거나, 부모의 Canvas Group에서 Interactable·Blocks Raycasts가 꺼져 있어도 클릭이 무시돼요.

이 항목들은 모두 해당 오브젝트를 선택한 뒤 오른쪽 [Inspector]에서 체크 상태로 확인할 수 있어요.


Standalone Input Module 문제를 재현하고 고치기

이 섹션에서는 가장 흔한 원인인 "모듈 불일치"를 일부러 만들고, 직접 고친 뒤 결과를 확인해요.

여기서 Console 창이 빨간 오류로 가득 차는 분들 분명히 계실 거예요. 처음 보면 무섭지만 원인은 대부분 한 가지라서 금방 고칠 수 있어요. 실습의 기준은 아래와 같아요.

- 입력: 버튼 1개가 있는 새 씬, Active Input Handling 설정값, EventSystem의 모듈 종류

- 출력: 버튼을 누를 때마다 Console에 "Button clicked"가 한 줄씩 찍히는 상태

- 검증 기준: 클릭 1번에 로그 1줄, 빨간 오류 0개

- 산출물: 수정 전후를 적은 점검 기록표 1장


STEP 1. 테스트용 버튼 만들기

① 상단 메뉴 [GameObject] → [UI] → [Button - TextMeshPro]를 선택해요. 버전에 따라 [UI] 메뉴 이름이 [UI (Canvas)]로 보일 수 있어요.


② TMP Importer 창이 뜨면 [Import TMP Essentials]를 클릭해요.

③ 왼쪽 [Hierarchy]에 Canvas, Button, EventSystem이 생겼는지 확인해요.




STEP 2. 클릭 로그 스크립트 연결하기

① 아래쪽 [Project] 창에서 Assets 폴더를 우클릭하고 [Create] → [Scripting] → [MonoBehaviour Script]를 선택해요.

② 파일 이름을 ClickLogger로 정해요. 파일 이름과 클래스 이름이 같아야 해요.

③ 스크립트를 열어 아래 내용으로 바꾸고 저장해요.


using UnityEngine;


public class ClickLogger : MonoBehaviour

{

    public void OnClicked()

    {

        Debug.Log("Button clicked");

    }

}


④ [Hierarchy]에서 Button을 선택하고 오른쪽 [Inspector] 맨 아래 [Add Component] → ClickLogger를 추가해요.


⑤ 같은 [Inspector]의 Button 컴포넌트에서 On Click () 목록 오른쪽 아래 [+] 버튼을 클릭해요.

⑥ 빈 칸에 [Hierarchy]의 Button을 끌어다 놓고, 함수 목록에서 [ClickLogger] → [OnClicked]를 선택해요.





STEP 3. 오류 상황 재현하기

① 상단 메뉴 [Edit] → [Project Settings] → 왼쪽 [Player] → [Other Settings]에서 [Active Input Handling]을 Input System Package (New)로 바꿔요. 에디터 재시작 안내가 나오면 저장 후 재시작해요.


② [Hierarchy]에서 EventSystem을 선택하고 [Inspector]의 모듈 컴포넌트를 확인해요.

③ 이미 Input System UI Input Module이라면, 재현을 위해 컴포넌트 오른쪽 위 점 세 개(⋮) 메뉴 → [Remove Component]로 지우고 [Add Component] → Standalone Input Module을 추가해요.

④ 상단 가운데 ▶ [Play] 버튼을 눌러 버튼을 클릭해요.

예상 결과는 "Button clicked" 로그가 찍히지 않고, Console에 InvalidOperationException 오류가 반복해서 나오는 상태예요.

오류 문장에는 "UnityEngine.Input 클래스로 입력을 읽으려 했지만 Player Settings에서 입력 방식을 Input System 패키지로 바꿨다"는 내용이 들어 있어요.

옛날 말만 아는 통역사(Standalone Input Module)가 새 입력을 읽으려다 실패한 거예요.


STEP 4. 원인 확인하기

① ▶ [Play] 버튼을 다시 눌러 Play 모드를 끝내요.

② EventSystem의 [Inspector]를 보면 Standalone Input Module 영역에 Input System용 모듈로 바꾸라는 안내와 교체 버튼이 보여요.

③ 이 안내가 보인다면 원인은 "입력 방식과 UI 모듈 불일치"로 확정할 수 있어요.


STEP 5. Input System UI Input Module로 교체하기

① STEP 4의 교체 버튼(Replace with InputSystemUIInputModule)을 클릭해요.

② 컴포넌트가 Input System UI Input Module로 바뀌었는지 확인해요.

③ 그 안의 [Actions Asset] 칸이 비어 있지 않은지 봐요. 기본값은 DefaultInputActions예요.


STEP 6. 수정 결과 검증하기

① ▶ [Play] 버튼을 눌러 버튼을 세 번 클릭해요.

② 아래쪽 [Console] 창에 "Button clicked"가 세 줄 찍히고 빨간 오류가 없으면 성공이에요.

③ 로그가 여전히 없다면 본문 1의 3·4단계(Graphic Raycaster, Raycast Target, Interactable)로 넘어가서 하나씩 확인해요.


  • Console에 오류가 없는데 버튼이 안 눌려요. 어디부터 봐야 하나요?
    • 오류가 없다면 모듈 문제보다는 "레이저가 버튼에 도착하지 못하는" 경우일 가능성이 커요.
    • 먼저 [Hierarchy]에서 Canvas를 선택해 [Inspector]에 Graphic Raycaster가 켜져 있는지 확인해요.
    • 다음으로 버튼 위에 겹친 Image나 Text를 찾아 Raycast Target 체크를 하나씩 꺼 보세요. 그래도 안 되면 Button의 Interactable과 부모 Canvas Group의 Interactable·Blocks Raycasts를 확인해요.
    • 투명한 유리벽을 하나씩 치운다고 생각하면 순서를 놓치지 않아요.
  • Active Input Handling을 Both로 두면 해결되지 않나요?
    • [Edit] → [Project Settings] → [Player] → [Active Input Handling]을 Both로 두면 예전 모듈도 입력을 읽을 수 있어서 오류가 사라질 수 있어요.
    • 하지만 이 방법은 두 입력 시스템을 동시에 돌리는 것이라 입력 처리가 두 번 일어나고 약간의 성능 비용이 생겨요.
    • 예전 Input 클래스 코드가 아직 많이 남아 있어서 옮기는 중이라면 임시로 써도 괜찮아요.
    • 새로 시작하는 프로젝트라면 Input System Package 하나로 통일하고 UI 모듈을 교체하는 편이 깔끔해요. 나중에 "어디서 입력을 읽고 있지?"라고 헷갈리는 일을 줄여 줘요.
  • 키보드로는 버튼 선택이 되는데 마우스 클릭만 안 돼요. 왜 그런가요?
    • Input System UI Input Module은 [Actions Asset]에 들어 있는 UI용 액션으로 입력을 읽어요.
    • 기본 에셋(DefaultInputActions)에는 Point(마우스 위치), Click(클릭), Navigate(방향키 이동), Submit(확인) 같은 액션이 들어 있어요.
    • 직접 만든 에셋으로 바꿨는데 Point나 Click에 마우스가 연결되어 있지 않으면, 키보드 이동은 되고 마우스 클릭만 안 될 수 있어요.
    • EventSystem의 [Inspector]에서 [Actions Asset]을 기본값으로 잠시 되돌려 비교해 보세요. 기본값에서 클릭이 된다면 직접 만든 에셋의 Point·Click 연결을 고치면 돼요.

UI 버튼이 안 눌릴 때는 클릭이 지나가는 길을 순서대로 따라가 보면 돼요.

첫째, EventSystem이 씬에 있는지 확인해요.

둘째, 모듈이 Active Input Handling 설정과 맞는지 봐요. 새 Input System이라면 Input System UI Input Module이어야 해요.

셋째, Graphic Raycaster와 Raycast Target, Interactable처럼 클릭을 막는 벽이 없는지 확인해요.

이 블로그의 인기 게시물

[Notion] 노션에서 페이지 간 링크 연결하는 방법 총정리

[Notion] 노션 문서 PDF로 저장하는 방법

[Notion] 노션 기본 템플릿 5가지 소개와 활용 팁