Addressables 빌드 후 로드가 실패할 때 (Invalid Key·카탈로그 불일치)

콘솔 첫 줄이 어느 쪽인지 먼저 가릅니다

Invalid Key가 즉시 뜨면 로드 키 문제입니다. 로드가 시작됐다가 시간이 초과되거나 404가 나면 카탈로그와 번들 경로 문제입니다. 이 갈림길을 먼저 정하지 않으면 엉뚱한 쪽을 고치게 됩니다.

Invalid Key 쪽

주소, 라벨, 에셋 참조 중 무엇으로 로드했는지와 Groups 창의 값이 글자 단위로 같은지 봅니다. 문자열 끝 공백, 대소문자, 붙어 있는 확장자가 흔한 원인입니다.

카탈로그가 오래된 쪽

Addressables Groups 창에서 Build > New Build > Default Build Script를 다시 돌려 카탈로그와 번들을 함께 새로 만듭니다. 이전 빌드의 카탈로그를 그대로 두고 에셋만 추가한 경우가 가장 많습니다.

var handle = Addressables.LoadAssetAsync<GameObject>("enemy/wave_03");
await handle.Task;
// 실패 원인은 여기 담깁니다
Debug.Log(handle.OperationException);

에디터에서 되고 기기에서만 실패하면 프로파일입니다

Play Mode Script와 Build Script가 서로 다른 프로파일(로컬/원격)을 보고 있으면 정확히 이 증상이 납니다. 프로파일을 하나로 맞추고 기기 캐시를 지우거나 앱을 다시 깔고 시도합니다.

카탈로그 빌드 시각이 에셋 추가 시각보다 앞서 있으면 그게 답입니다. 업데이트 배포까지 갈 거라면 Content Update Groups를 다음으로 보면 됩니다.

InvalidKeyException: enemy/wave_03 not found in catalog
Last catalog build: 08/28 17:42 (stale)