[Unity] Unity Input System 전환 뒤 기존 입력 오류
![]() |
| ChatGPT 생성 이미지 |
Unity Input System으로 바꾼 뒤 키 입력이 안 된다면
혹시 Unity에서 새 Input System으로 바꾼 뒤 캐릭터가 갑자기 움직이지 않은 적 있으세요?
저도 처음엔 이동 코드부터 뜯어봤는데, 원인은 코드가 아니라 프로젝트 설정이었어요.
Input System은 Package Manager로 설치하는 Unity 공식 입력 패키지예요.
기존 Input Manager와 키를 읽는 방식이 달라서 전환 직후 이런 문제가 자주 생겨요.
결론부터 말하면, 먼저 상단 메뉴 → [Edit] → [Project Settings] → [Player]에서 Active Input Handling(활성 입력 처리) 값을 확인하세요.
이 값과 스크립트가 쓰는 입력 API가 어긋나면 키 입력이 무시되거나 콘솔에 빨간 오류가 떠요.
이 글은 2Unity 공식 문서(Input System 1.14)를 바탕으로 정리했어요. 에디터 버전에 따라 메뉴 이름이 조금 다를 수 있으니, 설치한 에디터 화면을 같이 보면서 따라와 주세요.
Unity 키 입력이 안 되는 이유 4가지
이 섹션에서는 입력이 사라진 것처럼 보이는 원인을 네 가지 개념으로 나눠 봐요.
두 입력 방식은 호출법이 달라요
Unity에는 입력을 받는 방식이 두 가지 있어요. 기존 Input Manager는 `Input.GetKey`처럼 `UnityEngine.Input` 클래스를 직접 호출해요.
새 Input System은 Input Action(입력 동작)과 바인딩(Binding)을 통해 키보드·게임패드 입력을 받아요.
바인딩은 쉽게 말하면 '이 동작에 어떤 키를 연결할지 적어 둔 메모'예요. 리모컨 두 종류를 떠올려 보세요. TV가 한 리모컨 신호만 받도록 설정돼 있으면 다른 리모컨 버튼은 아무리 눌러도 반응하지 않아요.
설정은 프로젝트 단위예요
Active Input Handling은 에디터 전체가 아니라 프로젝트마다 따로 저장되는 설정이에요. 그래서 다른 프로젝트에서 잘 되던 코드가 새 프로젝트에서는 안 될 수 있어요.
위치는 상단 메뉴 → [Edit] → [Project Settings] → 왼쪽 목록 [Player] → [Other Settings] → [Active Input Handling]이에요.
선택지는 `Input Manager (Old)`, `Input System Package (New)`, `Both` 세 가지예요. 공식 문서에 따르면 이 값을 바꾸면 에디터를 다시 시작해야 적용돼요.
Action은 활성화돼야 키를 들어요
새 Input System의 Input Action은 만들어 두기만 해서는 키를 감지하지 않아요.
공식 API 문서는 Action이 활성화(Enable)된 뒤에야 장치의 입력을 감시한다고 설명해요.
전등 스위치를 달아 놓아도 차단기를 올리지 않으면 불이 안 켜지는 것과 비슷해요.
단, 프로젝트 단위 액션(Project-wide Actions)은 기본으로 활성화돼 있어요.
직접 만든 Action 에셋이나 코드에서 만든 Action이라면 `Enable()` 호출이나 PlayerInput 컴포넌트 연결을 확인하세요.
바인딩이 다른 키나 다른 Control Scheme(장치 조합 설정, 예: 키보드용·게임패드용)에 연결돼 있어도 반응이 없을 수 있어요.
입력 수신과 화면 반응을 나눠서 봐요
키를 눌러도 캐릭터가 안 움직이는 이유는 하나가 아니에요.
입력이 안 들어온 경우, 이벤트 연결이 빠진 경우, 이동 컴포넌트가 꺼진 경우가 모두 같은 증상으로 보여요.
그래서 입력을 받는 지점에 로그 한 줄을 남겨 첫 갈림길을 확인해요.
로그가 찍히면 이동 코드를, 안 찍히면 설정과 바인딩을 보면 돼요. 택배가 안 왔을 때 '발송됐는지'부터 조회하는 것과 같은 원리예요.
이 섹션에서는 입력이 사라진 것처럼 보이는 원인을 네 가지 개념으로 나눠 봐요.
두 입력 방식은 호출법이 달라요
Unity에는 입력을 받는 방식이 두 가지 있어요.
기존 Input Manager는 `Input.GetKey`처럼 `UnityEngine.Input` 클래스를 직접 호출해요.
새 Input System은 Input Action(입력 동작)과 바인딩(Binding)을 통해 키보드·게임패드 입력을 받아요. 바인딩은 쉽게 말하면 '이 동작에 어떤 키를 연결할지 적어 둔 메모'예요.
리모컨 두 종류를 떠올려 보세요. TV가 한 리모컨 신호만 받도록 설정돼 있으면 다른 리모컨 버튼은 아무리 눌러도 반응하지 않아요.
설정은 프로젝트 단위예요
Active Input Handling은 에디터 전체가 아니라 프로젝트마다 따로 저장되는 설정이에요.
그래서 다른 프로젝트에서 잘 되던 코드가 새 프로젝트에서는 안 될 수 있어요.
위치는 상단 메뉴 → [Edit] → [Project Settings] → 왼쪽 목록 [Player] → [Other Settings] → [Active Input Handling]이에요. 선택지는 `Input Manager (Old)`, `Input System Package (New)`, `Both` 세 가지예요. 공식 문서에 따르면 이 값을 바꾸면 에디터를 다시 시작해야 적용돼요.
Action은 활성화돼야 키를 들어요
새 Input System의 Input Action은 만들어 두기만 해서는 키를 감지하지 않아요.
공식 API 문서는 Action이 활성화(Enable)된 뒤에야 장치의 입력을 감시한다고 설명해요.
전등 스위치를 달아 놓아도 차단기를 올리지 않으면 불이 안 켜지는 것과 비슷해요.
단, 프로젝트 단위 액션(Project-wide Actions)은 기본으로 활성화돼 있어요. 직접 만든 Action 에셋이나 코드에서 만든 Action이라면 `Enable()` 호출이나 PlayerInput 컴포넌트 연결을 확인하세요.
바인딩이 다른 키나 다른 Control Scheme(장치 조합 설정, 예: 키보드용·게임패드용)에 연결돼 있어도 반응이 없을 수 있어요.
입력 수신과 화면 반응을 나눠서 봐요
키를 눌러도 캐릭터가 안 움직이는 이유는 하나가 아니에요.
입력이 안 들어온 경우, 이벤트 연결이 빠진 경우, 이동 컴포넌트가 꺼진 경우가 모두 같은 증상으로 보여요.
그래서 입력을 받는 지점에 로그 한 줄을 남겨 첫 갈림길을 확인해요. 로그가 찍히면 이동 코드를, 안 찍히면 설정과 바인딩을 보면 돼요. 택배가 안 왔을 때 '발송됐는지'부터 조회하는 것과 같은 원리예요.
WASD로 움직이는 큐브로 입력 오류 재현하고 해결하기
이 섹션에서는 WASD로 움직이는 플레이어 큐브를 만들어 일부러 오류를 내고, 원인을 확인한 뒤, 세 가지 방법 중 하나로 고쳐 봐요.
여기서 빨간 오류가 수십 줄씩 쌓여서 당황하는 분들 분명히 계실 거예요.
저도 처음엔 코드가 통째로 망가진 줄 알았어요. 원본 프로젝트가 걱정되면 새 프로젝트나 복사본에서 진행하세요. 이 실습은 Unity 6000.3.24f1, Input System 1.20.0, URP 기본 템플릿 프로젝트에서 실행해 확인했어요.
실습 장면 구성
카메라를 위에서 비스듬히 내려다보게 두면 큐브가 앞뒤좌우로 움직이는 게 한눈에 보여요.
| 오브젝트 | 만드는 방법 | 설정값 |
|---|---|---|
| Floor | [Hierarchy] 마우스 오른쪽 클릭 → [3D Object] → [Plane] | Position (0, 0, 0) Scale (2, 1, 2) |
| Player | [Hierarchy] 마우스 오른쪽 클릭 → [3D Object] → [Cube] | Position (0, 0.5, 0) Scale (1, 1, 1) |
| Main Camera | 새 장면에 기본으로 있어요 | Position (0, 8, -8) Rotation (45, 0, 0) |
스크립트 1. 지금 어떤 입력 방식인지 알려 주는 InputModeReporter
설정 창을 매번 열지 않아도 Play를 누르면 Console에 현재 입력 방식이 찍히게 만들어요. `ENABLE_INPUT_SYSTEM`과 `ENABLE_LEGACY_INPUT_MANAGER`는 Active Input Handling 값에 따라 Unity가 자동으로 켜 주는 표시예요.
using UnityEngine;
public class InputModeReporter : MonoBehaviour
{
void Start()
{
#if ENABLE_INPUT_SYSTEM && ENABLE_LEGACY_INPUT_MANAGER
string mode = "Both";
#elif ENABLE_INPUT_SYSTEM
string mode = "Input System Package (New)";
#else
string mode = "Input Manager (Old)";
#endif
Debug.Log($"[InputLab] Active Input Handling = {mode}");
}
}
오류를 재현할 OldInputMover (기존 방식)
인터넷 예제에서 가장 흔히 보는 이동 코드예요. `Horizontal`은 A·D와 ←·→, `Vertical`은 W·S와 ↑·↓ 키에 연결된 기존 Input Manager의 기본 축이에요.
using UnityEngine;
public class OldInputMover : MonoBehaviour
{
[SerializeField] float speed = 3f;
bool loggedFirstInput;
void Update()
{
float x = Input.GetAxisRaw("Horizontal");
float z = Input.GetAxisRaw("Vertical");
Vector3 direction = new Vector3(x, 0f, z);
if (direction.sqrMagnitude > 0f && !loggedFirstInput)
{
Debug.Log($"[InputLab] OldInputMover 입력 수신 ({x}, {z})");
loggedFirstInput = true;
}
transform.Translate(direction.normalized * speed * Time.deltaTime, Space.World);
}
}
① 상단 메뉴 → [Edit] → [Project Settings]를 열고, 왼쪽 목록 [Player] → [Other Settings]를 펼쳐 [Active Input Handling] 값을 메모하세요.
이 실습에 쓴 Unity 6 URP 기본 템플릿 프로젝트는 `Input System Package (New)`로 되어 있었어요.
② [Project] 창의 Assets 폴더에서 마우스 오른쪽 클릭 → [Create] → [Scripting] → [MonoBehaviour Script]로 스크립트 두 개를 만들어요.
이름을 각각 InputModeReporter, OldInputMover로 정하고 위 코드를 붙여 넣은 뒤 저장하세요. 파일 이름과 클래스 이름이 같아야 컴포넌트로 붙일 수 있어요.
③ 위 표대로 Floor와 Player를 만들고, Main Camera 값을 바꿔요.
그다음 [Hierarchy]에서 Player를 선택하고 오른쪽 [Inspector] 맨 아래 [Add Component] 버튼을 눌러 InputModeReporter와 OldInputMover를 검색해 추가하세요.
④ 화면 위쪽 가운데 [Play] 버튼(▶ 삼각형 모양)을 누르고 D 키를 꾹 눌러 보세요. 큐브는 꼼짝도 하지 않고, 하단 [Console] 창에는 이런 로그가 찍혀요.
[InputLab] Active Input Handling = Input System Package (New)
InvalidOperationException: You are trying to read Input using the UnityEngine.Input class, but you have switched active Input handling to Input System package in Player Settings.
첫 줄은 "지금 프로젝트는 새 방식만 켜져 있다"는 뜻이에요. 둘째 줄은 "그런데 코드가 기존 방식인 `UnityEngine.Input`을 불렀다"는 뜻이고요. `Update`가 매 프레임 실행되니 같은 오류가 계속 쌓이고, 오류가 난 줄 아래 이동 코드는 실행되지 않아요. 오류를 더블 클릭하면 OldInputMover의 `Input.GetAxisRaw` 줄로 바로 이동하니 줄 번호를 메모해 두세요.
⑤ [Play] 버튼을 다시 눌러 Play Mode를 끈 뒤, 아래 세 가지 해결 방법 중 하나를 골라요. 한 오브젝트에 기존 방식과 새 방식 이동 스크립트를 동시에 켜 두지 않는 게 중요해요.
방법 A. 설정을 Both로 바꾸기 (기존 코드 유지)
①의 [Active Input Handling]을 `Both`로 바꿔요. 재시작 안내 창이 뜨면 안내에 따라 에디터를 다시 시작하세요. 다시 Play를 누르면 첫 줄이 `Active Input Handling = Both`로 바뀌고, 빨간 오류도 더 이상 쌓이지 않아요.
D 키를 눌러 `[InputLab] OldInputMover 입력 수신 (1, 0)` 로그와 함께 큐브가 오른쪽으로 움직이는지 확인하세요. 코드를 한 줄도 안 고쳐도 되지만, 두 입력 방식을 모두 켠 임시 상태라는 점은 기억해 두세요.
방법 B-1. 키보드를 직접 읽는 NewInputMover (가장 간단한 전환)
설정은 `Input System Package (New)` 그대로 두고 코드를 새 방식으로 바꿔요. `Keyboard.current`는 지금 연결된 키보드를 가리키고, `isPressed`는 그 키가 눌려 있는지 알려 줘요.
using UnityEngine;
using UnityEngine.InputSystem;
public class NewInputMover : MonoBehaviour
{
[SerializeField] float speed = 3f;
bool loggedFirstInput;
void Update()
{
Keyboard keyboard = Keyboard.current;
if (keyboard == null) return; // 키보드가 없는 환경
float x = 0f, z = 0f;
if (keyboard.aKey.isPressed || keyboard.leftArrowKey.isPressed) x -= 1f;
if (keyboard.dKey.isPressed || keyboard.rightArrowKey.isPressed) x += 1f;
if (keyboard.sKey.isPressed || keyboard.downArrowKey.isPressed) z -= 1f;
if (keyboard.wKey.isPressed || keyboard.upArrowKey.isPressed) z += 1f;
Vector3 direction = new Vector3(x, 0f, z);
if (direction.sqrMagnitude > 0f && !loggedFirstInput)
{
Debug.Log($"[InputLab] NewInputMover 입력 수신 ({x}, {z})");
loggedFirstInput = true;
}
transform.Translate(direction.normalized * speed * Time.deltaTime, Space.World);
}
}
Player의 [Inspector]에서 OldInputMover 이름 왼쪽 체크박스를 끄고, NewInputMover를 추가하세요. Play 후 D 키를 누르면 오류 없이 `[InputLab] NewInputMover 입력 수신 (1, 0)`이 찍히고 큐브가 초당 3칸씩 오른쪽으로 움직여요.
방법 B-2. Input Action으로 바꾸는 ActionInputMover (본격 전환)
키를 코드에 직접 박지 않고 "Move"라는 동작에 키를 연결하는 방식이에요.
나중에 게임패드를 추가하거나 키 설정 메뉴를 만들 때 이 방식이 편해요. `Enable Action On Start` 체크를 일부러 끄면 "오류는 없는데 키가 안 먹는" 상황도 재현할 수 있어요.
using UnityEngine;
using UnityEngine.InputSystem;
public class ActionInputMover : MonoBehaviour
{
[SerializeField] float speed = 3f;
[SerializeField] bool enableActionOnStart = true;
InputAction moveAction;
void Awake()
{
moveAction = new InputAction("Move", InputActionType.Value, expectedControlType: "Vector2");
moveAction.AddCompositeBinding("2DVector")
.With("Up", "<Keyboard>/w").With("Down", "<Keyboard>/s")
.With("Left", "<Keyboard>/a").With("Right", "<Keyboard>/d");
}
void OnEnable()
{
if (enableActionOnStart) moveAction.Enable();
Debug.Log($"[InputLab] Move Action enabled = {moveAction.enabled}");
}
void OnDisable() => moveAction.Disable();
void OnDestroy() => moveAction.Dispose();
void Update()
{
Vector2 input = moveAction.ReadValue<Vector2>();
transform.Translate(new Vector3(input.x, 0f, input.y).normalized * speed * Time.deltaTime, Space.World);
}
}
`Enable Action On Start`를 켠 채 Play하면 `Move Action enabled = True`가 찍히고 W 키로 큐브가 앞으로 움직여요.
체크를 끄고 Play하면 `Move Action enabled = False`가 찍히고, W 키를 눌러도 큐브가 움직이지 않는데 빨간 오류는 하나도 안 떠요. 본문 1에서 말한 "Action은 활성화돼야 키를 들어요"를 눈으로 확인하는 장면이에요.
⑥ 고른 방법으로 다시 [Play]를 누르고 WASD를 차례로 눌러 보세요.
D는 오른쪽(+X), A는 왼쪽, W는 앞쪽(+Z), S는 뒤쪽으로 움직이면 성공이에요. 로그는 찍히는데 큐브가 안 움직인다면 입력은 정상이니, 이동 코드나 Player 오브젝트를 살펴볼 차례예요.
⑦ 마지막으로 진단 표를 채워 두세요. 아래는 이 실습을 Unity 테스트 도구의 가상 키보드로 실행해서 채운 예시예요.
방법 A는 가상 키보드로 기존 입력을 흉내 낼 수 없어서, 오류가 사라지는 것까지만 확인했어요. 큐브가 실제로 움직이는지는 여러분 키보드로 직접 눌러 보고 채워 주세요. 다음 프로젝트에서 같은 문제가 생기면 이 표의 빈칸만 채워도 원인이 좁혀져요.
| 상황 | Active Input Handling | 켠 스크립트 | Console 결과 | 큐브 움직임 |
|---|---|---|---|---|
| 오류 재현 | Input System Package (New) | OldInputMover |
InvalidOperationException 반복 |
안 움직임 |
| 방법 A | Both | OldInputMover |
Active Input Handling = Both, 오류 없음 |
(직접 확인) |
| 방법 B-1 | Input System Package (New) | NewInputMover |
오류 없음, 입력 수신 (1, 0) |
D 키로 +X 이동 |
| 방법 B-2 (Action 켬) |
Input System Package (New) | ActionInputMover |
Move Action enabled = True | W 키로 +Z 이동 |
| 방법 B-2 (Action 끔) |
Input System Package (New) | ActionInputMover |
Move Action enabled = False, 오류 없음 |
안 움직임 |
- Active Input Handling을 Both로 바꾸면 무조건 해결되나요?
- Both는 기존 방식과 새 방식을 동시에 허용하는 설정이라, ④의 InvalidOperationException 오류는 사라져요.
- 하지만 원인이 Action 비활성화나 잘못된 바인딩이라면 Both로 바꿔도 여전히 입력이 없어요.
- 그러니 먼저 스크립트가 UnityEngine.Input과 새 Input System 중 무엇을 쓰는지 확인하세요.
- 설정 위치는 상단 메뉴 → [Edit] → [Project Settings] → [Player] → [Other Settings] → [Active Input Handling]이에요.
- Both는 전환 기간의 임시 다리라고 생각하고, 최종적으로 쓸 방식을 정해 두는 편이 관리하기 쉬워요.
- Console에 오류가 없는데도 키 입력이 안 돼요. 어디를 봐야 하나요?
- 오류가 없다는 건 설정과 API가 충돌하지 않는다는 뜻일 뿐, 입력이 들어왔다는 뜻은 아니에요.
- 먼저 입력을 받는 코드나 콜백(입력이 들어왔을 때 자동으로 실행되는 함수)에 Debug.Log 한 줄을 넣어 이벤트가 오는지 확인하세요.
- 로그가 없다면 [Project] 창에서 Action 에셋을 더블 클릭해 편집 창을 열고, 해당 Action에 원하는 키가 바인딩됐는지 보세요.
- PlayerInput 컴포넌트를 쓴다면 오른쪽 [Inspector] 창에서 [Actions] 칸에 올바른 에셋이 들어 있는지, [Behavior] 설정에 맞게 이벤트가 연결됐는지 확인해요.
- 로그가 찍힌다면 입력은 정상이니 이동 컴포넌트와 대상 오브젝트로 넘어가면 돼요.
- 에디터에서는 되는데 빌드한 게임에서는 키가 안 먹혀요. 같은 문제인가요?
- 비슷해 보이지만 원인이 다를 수 있어서 따로 확인해야 해요. 먼저 상단 메뉴 → [Edit] → [Project Settings] → [Player]에서 빌드 대상 플랫폼 탭을 고르고, [Other Settings] → [Active Input Handling] 값이 예상과 같은지 보세요.
- 다음으로 개발용 빌드(Development Build)를 켜고 빌드해서 빌드 쪽 로그를 확인하세요.
- 상단 메뉴 → [File] → Build Profiles에서 [Development Build]를 체크하면 돼요. 에디터와 빌드 로그를 나란히 놓고 어느 단계에서 입력 이벤트가 사라지는지 비교하면 원인을 좁힐 수 있어요.
Unity에서 키 입력이 안 될 때는 세 가지만 순서대로 보면 돼요.
첫째는 Active Input Handling 값, 둘째는 스크립트가 쓰는 입력 API, 셋째는 Action 활성화와 바인딩 상태예요.
입력 로그와 캐릭터 움직임을 나눠서 기록하는 습관만 들여도 디버깅 시간이 확 줄어들어요. 처음엔 헷갈려도 진단 표를 한 번 채워 보면 금방 익숙해질 거예요.





