Skip to Content
개발자에러 레퍼런스에러 레퍼런스

에러 레퍼런스

정확한 코드를 찾고, 오류가 발생한 경계와 다음 대응을 확인하세요.

211개 코드

ABP_APPLICATION/ALREADY_EXISTS이미 등록된 신청입니다.ABP_APPLICATION/COUNT_DOCUMENTS_FAILED신청 문서 수를 조회하지 못했습니다.ABP_APPLICATION/CREATE_DOCUMENT_FAILED신청 문서를 만들지 못했습니다.ABP_APPLICATION/INVALID_EMAIL이메일 주소가 올바르지 않습니다.ABP_APPLICATION/NOT_FOUND신청 정보를 찾을 수 없습니다.ABP_APPLICATION/READ_DOCUMENT_FAILED신청 문서를 읽지 못했습니다.ABP_APPLICATION/READ_SETTING_FAILED신청 설정을 읽지 못했습니다.ABP_APPLICATION/REQUIRED_FIELD_MISSING필수 입력 항목이 빠져 있습니다.ABP_APPLICATION/REQUIRED_PROFILE_MISSING필수 프로필 정보가 빠져 있습니다.ABP_APPLICATION/SETTING_NOT_FOUND신청 설정을 찾을 수 없습니다.ABP_APPLICATION/UPDATE_DOCUMENT_FAILED신청 문서를 갱신하지 못했습니다.AUTH/ADDRESS_MISMATCH인증 정보의 주소와 요청 주소가 일치하지 않습니다.AUTH/HANDSHAKE_MISSING_FIELDS연결 인증에 필요한 필드가 빠져 있습니다.AUTH/HOST_MISMATCH토큰이 연결된 호스트와 접속한 호스트가 다릅니다.AUTH/INVALID_TOKEN_RECORD저장된 토큰 기록의 형식이나 내용이 올바르지 않습니다.AUTH/LOGIN_ATTEMPT_DATA_INVALID저장된 소셜 로그인 시도 정보의 형식이 올바르지 않습니다.AUTH/LOGIN_ATTEMPT_STORAGE_FAILED소셜 로그인 시도 정보를 저장하거나 처리하지 못했습니다.AUTH/LOGIN_CODE_DATA_INVALID저장된 일회용 로그인 코드 정보의 형식이 올바르지 않습니다.AUTH/LOGIN_CODE_INVALID일회용 로그인 코드가 없거나 만료되었거나 유효하지 않습니다.AUTH/LOGIN_CODE_STORAGE_FAILED일회용 로그인 코드 저장소를 처리하지 못했습니다.NOT_AUTHENTICATED인증된 세션이 필요한 동작입니다.AUTH/NOT_INITALIZED_WALLET동작에 필요한 지갑이 초기화되지 않았습니다.AUTH/OAUTH_INVALID_CALLBACK_URL설정된 앱 콜백 URL이 올바르지 않습니다.AUTH/OAUTH_INVALID_STATE제공자의 인증 상태가 유효한 로그인 시도와 연결되지 않습니다.AUTH/OAUTH_NOT_CONFIGURED선택한 로그인 제공자가 서버에 설정되어 있지 않습니다.AUTH/OAUTH_PROVIDER_FAILED소셜 로그인 제공자의 인증 처리가 실패했습니다.AUTH/REFRESH_TOKEN_DATA_INVALID저장된 갱신 세션 정보의 형식이 올바르지 않습니다.AUTH/REFRESH_TOKEN_INVALID갱신 토큰이 없거나 만료·사용되었거나 유효하지 않습니다.AUTH/REFRESH_TOKEN_STORAGE_FAILED갱신 토큰 저장소를 처리하지 못했습니다.AUTH/ROOM_MISMATCH토큰에 연결된 방과 요청한 방이 다릅니다.AUTH/TOKEN_ISSUANCE_FAILED서버가 서비스 접근 토큰을 발급하지 못했습니다.AUTH/TOKEN_MISMATCH제출한 토큰과 서버가 기대하는 토큰이 다릅니다.AUTH/TOKEN_NOT_CONFIGURED서비스 토큰 서명 설정이 없거나 올바르지 않습니다.AUTH/TOKEN_NOT_FOUND서버 저장소에서 토큰 기록을 찾을 수 없습니다.AUTH/WEB3_AUTH_NOT_INITIALIZED서명 등에 필요한 Web3 인증 상태가 초기화되지 않았습니다.AXIOS/HTTP<status>Axios 오류를 실제 HTTP 응답 상태로 분류하는 동적 코드 계열입니다.AXIOS/UNKNOWNAxios 오류를 더 구체적인 유형으로 분류하지 못했습니다.BLOCK/NOT_FOUND요청한 블록을 등록 정보에서 찾을 수 없습니다.BLOCK/NOT_PERMISSION이 블록을 변경할 권한이 없습니다.BLOCK/TEST_ERROR블록 오류 처리 경로를 검증하기 위한 의도적인 테스트 오류입니다.BLUEPRINT/ASSET_UPLOAD_FAILED블루프린트 자산을 업로드하지 못했습니다.BLUEPRINT/CREATE_DOCUMENT_FAILED블루프린트 문서를 만들지 못했습니다.BLUEPRINT/DELETE_DOCUMENT_FAILED블루프린트 문서를 삭제하지 못했습니다.BLUEPRINT/FORBIDDEN블루프린트에 접근하거나 변경할 권한이 없습니다.BLUEPRINT/INVALID_ASSET블루프린트 자산이 검증 조건을 만족하지 않습니다.BLUEPRINT/INVALID_STATUS_TRANSITION요청한 블루프린트 상태 전환은 허용되지 않습니다.BLUEPRINT/LIST_DOCUMENTS_FAILED블루프린트 목록을 읽지 못했습니다.BLUEPRINT/MISSING_BLUEPRINT_FILE요청에 블루프린트 파일이 없습니다.BLUEPRINT/NOT_FOUND블루프린트를 찾을 수 없습니다.BLUEPRINT/PINNED_MAX_COUNT_REACHED블루프린트 고정 개수의 상한에 도달했습니다.BLUEPRINT/READ_DOCUMENT_FAILED블루프린트 문서를 읽지 못했습니다.BLUEPRINT/UPDATE_DOCUMENT_FAILED블루프린트 문서를 갱신하지 못했습니다.BUG_REPORT/ADD_SCREENSHOTS_FAILED오류 신고에 스크린샷을 추가하지 못했습니다.BUG_REPORT/COUNT_DOCUMENTS_FAILED오류 신고 문서 수를 조회하지 못했습니다.BUG_REPORT/CREATE_DOCUMENT_FAILED오류 신고 문서를 만들지 못했습니다.BUG_REPORT/CREATED_BY_ADDRESS_MISMATCH신고 작성자 주소와 인증된 주소가 다릅니다.BUG_REPORT/IMAGE_UPLOAD_FAILED신고 이미지를 업로드하지 못했습니다.BUG_REPORT/INVALID_IMAGE신고 이미지가 파일 검증 조건을 만족하지 않습니다.BUG_REPORT/INVALID_PAYLOAD_JSON신고 페이로드가 유효한 JSON이 아닙니다.BUG_REPORT/LIST_DOCUMENTS_FAILED오류 신고 목록을 읽지 못했습니다.BUG_REPORT/NO_BUG_REPORT_ID_PROVIDED오류 신고 ID가 제공되지 않았습니다.BUG_REPORT/NOT_FOUND오류 신고를 찾을 수 없습니다.BUG_REPORT/PAYLOAD_JSON_MUST_BE_OBJECT신고 JSON은 객체여야 합니다.BUG_REPORT/READ_DOCUMENT_FAILED오류 신고 문서를 읽지 못했습니다.GET_REALM_BY_SLUG_FAILED계약 어댑터에서 slug로 월드를 조회하지 못했습니다.ERROR_CHAT_INVAILD_COMMAND_FORMAT채팅 명령 형식이 올바르지 않습니다. 기존 코드의 철자는 호환성을 위해 유지됩니다.ERROR_CHAT_RATE_LIMIT채팅 전송 빈도가 제한을 초과했습니다.ERROR_CHAT_TARGET_AMBIGUOUS동일한 이름의 수신자가 여러 명입니다.ERROR_CHAT_TARGET_NOT_FOUND채팅 수신자를 찾을 수 없습니다.ERROR_INVITE_TARGET_NOT_FOUND초대할 플레이어를 찾을 수 없습니다.ERROR_PLAYER_NOT_EXIST해당 플레이어를 찾을 수 없습니다.ERROR_PLAYER_NOT_IN_ROOM플레이어가 해당 방에 없습니다.ERROR_ROOM_NOT_FOUND해당 방을 찾을 수 없습니다.FACILITY/BUSY시설이 다른 동작을 처리하고 있습니다.FACILITY/CONNECTION_FAILED시설 처리 서비스와 통신하지 못했습니다.FACILITY/INPUT_MISMATCH제출한 재료와 권위 있는 입력 상태가 일치하지 않습니다.FACILITY/INPUT_SLOT_CHANGED처리 중 시설 입력 슬롯이 변경되었습니다.FACILITY/INSUFFICIENT_CHARGE시설 충전량이 부족합니다.FACILITY/INSUFFICIENT_INPUTS제작에 필요한 실제 재료가 부족합니다.FACILITY/INVALID_INPUT_EQUIPMENT입력한 장비가 작업 조건을 만족하지 않습니다.FACILITY/INVALID_INPUT_SLOTS시설 입력 슬롯 목록이나 형식이 올바르지 않습니다.FACILITY/INVALID_RECIPE레시피가 유효하지 않습니다.FACILITY/INVALID_REQUEST시설 요청이 유효하지 않습니다.FACILITY/INVENTORY_CAPACITY_INVALID인벤토리 용량 상태를 유효하게 판정할 수 없습니다.FACILITY/INVENTORY_FULL제작 결과를 넣을 인벤토리 공간이 부족합니다.FACILITY/INVENTORY_OUT_OF_SYNC인벤토리가 권위 있는 상태와 동기화되지 않았습니다.FACILITY/NOT_FOUND시설을 찾을 수 없습니다.FACILITY/PERMISSION_DENIED시설을 사용할 권한이 없습니다.FACILITY/RECIPE_NOT_ALLOWED이 시설에서 해당 레시피를 사용할 수 없습니다.FACILITY/REQUEST_CONFLICT시설 요청이 다른 처리나 기존 요청 상태와 충돌합니다.FACILITY/REQUEST_FAILED시설 요청을 완료하지 못했습니다.FACILITY/SESSION_CHANGED시설 작업 중 세션이 변경되었습니다.FACILITY/STATE_CHANGED시설 상태가 변경되어 요청을 계속할 수 없습니다.FACILITY/UNAVAILABLE현재 시설을 사용할 수 없습니다.FACILITY/WORLD_UNAVAILABLE시설이 있는 월드를 사용할 수 없습니다.FIRESTORE/COUNT_FAILEDFirestore 기록 수를 조회하지 못했습니다.FIRESTORE/CREATE_FAILEDFirestore 기록을 만들지 못했습니다.FIRESTORE/DELETE_FAILEDFirestore 기록을 삭제하지 못했습니다.FIRESTORE/GET_FAILEDFirestore 기록을 읽지 못했습니다.FIRESTORE/UPDATE_FAILEDFirestore 기록을 갱신하지 못했습니다.GET_TOTAL_BLOCK_SIZE_FAILED계약에서 전체 블록 수를 읽지 못했습니다.GRANT_NOT_FOUND우편 지급 기록을 찾을 수 없습니다.HTTP/<status>실제 HTTP 응답 상태로 오류를 분류하는 동적 코드 계열입니다.IDEMPOTENCY_CONFLICT같은 멱등성 식별자로 제출한 지급 요청의 내용이 충돌합니다.INTERNAL/UNEXPECTED더 구체적으로 분류되지 않은 내부 오류입니다.INVALID_GRANT_ID우편 지급 ID가 올바르지 않습니다.INVALID_MAILBOX_AUTHORITY우편함 작업 권위 정보가 올바르지 않습니다.INVALID_MAILBOX_CURSOR우편함 조회 커서가 올바르지 않습니다.INVALID_MAILBOX_GRANT_STATUS우편 지급 기록의 상태가 요청 조건과 맞지 않습니다.INVALID_MAILBOX_GRANT우편 지급 데이터가 올바르지 않습니다.INVALID_MAILBOX_QUERY우편함 조회 조건이 올바르지 않습니다.INVALID_PLAYER_EXPERIENCE_AMOUNT지급할 경험치 수량이 올바르지 않습니다.INVALID_PLAYER_EXPERIENCE_INPUT경험치 갱신 입력이 올바르지 않습니다.INVENTORY/AUTHORITY_UNAVAILABLE인벤토리 권위 상태를 사용할 수 없습니다.INVENTORY/CHECKPOINT_FAILED인벤토리 체크포인트 저장이 실패했습니다.INVENTORY/LEASE_INVALID현재 인벤토리 작업을 수행할 유효한 임대가 없습니다.INVENTORY/RECEIPT_PENDING인벤토리에 반영할 처리 영수증이 아직 대기 중입니다.INVENTORY/REVISION_CONFLICT인벤토리 리비전이 기대한 값과 다릅니다.INVENTORY_BINDING_CONFLICT인벤토리의 소유 또는 연결 정보가 충돌합니다.INVENTORY_CAPACITY_EXCEEDED수령으로 인벤토리 슬롯 용량을 초과합니다.INVENTORY_LEASE_ACTIVE활성 인벤토리 임대로 인해 해당 작업을 진행할 수 없습니다.INVENTORY_NOT_PROVISIONED인벤토리가 아직 준비되지 않았습니다.INVENTORY_POLICY_UNAVAILABLE인벤토리 정책을 사용할 수 없습니다.INVENTORY_WEIGHT_EXCEEDED수령으로 인벤토리 무게 제한을 초과합니다.ITEM_NOT_FOUND요청한 아이템을 찾을 수 없습니다.LIST_BLOCKS_FAILED계약의 블록 목록을 읽지 못했습니다.LIST_ROLE_GRANTS_FAILED계약의 역할 부여 목록을 읽지 못했습니다.LIST_WORLD_MASTERS_FAILED계약의 월드 관리자 목록을 읽지 못했습니다.INVENTORY_LEASE_INVALID우편 수령에 필요한 인벤토리 임대가 유효하지 않습니다.INVENTORY_REVISION_CONFLICT우편 수령 시 인벤토리 리비전이 충돌했습니다.MAILBOX_BINDING_CONFLICT우편함 소유 또는 연결 정보가 충돌합니다.MAILBOX_CAPACITY_EXCEEDED우편함 용량을 초과합니다.MAILBOX_CLAIM_CONFLICT우편 수령이 다른 처리와 충돌합니다.MAILBOX_POLICY_UNAVAILABLE우편함 정책을 사용할 수 없습니다.MAILBOX_RECEIPT_MISMATCH우편 수령 영수증과 기대 상태가 일치하지 않습니다.MAILBOX_SLOT_MISMATCH우편함 슬롯과 지급 정보가 일치하지 않습니다.MASTER_DATA/CSV_EMPTY마스터 데이터 CSV가 비어 있습니다.MASTER_DATA/CSV_INVALID마스터 데이터 CSV가 올바르지 않습니다.MASTER_DATA/HANDLER_NOT_REGISTERED해당 마스터 데이터를 처리할 핸들러가 등록되지 않았습니다.MULTIPLAYER/CONNECTION_VERIFICATION_FAILED대상 방에 대한 플레이어 연결 검증이 실패했습니다.MULTIPLAYER/ROOM_FULL방의 최대 플레이어 수에 도달했습니다.NETWORK/TIMEOUT네트워크 요청이 제한 시간 안에 완료되지 않았습니다.NETWORK/UNREACHABLE네트워크 대상에 연결할 수 없습니다.NETWORK/VERIFY_META_NOT_FOUND연결 검증에 필요한 메타데이터를 찾을 수 없습니다.NO_HANDLER_TYPE/COMMUNICATE수신한 Communicate 메시지 종류에 대응하는 핸들러가 없습니다.NO_HANDLER_TYPE/MULTIPLAYER수신한 멀티플레이 메시지 종류에 대응하는 핸들러가 없습니다.NO_HANDLER_TYPE/TERRAIN수신한 지형 메시지 종류에 대응하는 핸들러가 없습니다.PLAYER_NOT_FOUND현재 방에서 해당 플레이어 엔티티를 찾을 수 없습니다.PLAYER_EXPERIENCE_DEFINITION_UNAVAILABLE경험치 계산에 필요한 정의를 사용할 수 없습니다.PLAYER_EXPERIENCE_IDEMPOTENCY_CONFLICT경험치 지급의 멱등성 식별자와 요청 내용이 충돌합니다.PLAYER_EXPERIENCE_OVERFLOW경험치 갱신이 허용 수치 범위를 초과합니다.PLAYER_NOT_SYNCHRONIZED플레이어 데이터가 아직 동기화되지 않았습니다.PORTAL/DESTINATION_FULL목적지 월드의 정원이 찼습니다.PORTAL/DESTINATION_NOT_READY목적지 월드가 아직 활성 상태가 아닙니다.PORTAL/DESTINATION_PRIVATE목적지 월드가 이 플레이어에게 공개되어 있지 않습니다.REALM_NOT_FOUND요청한 월드를 찾거나 접근 가능 상태로 확인할 수 없습니다.REALM/PINNED_MAX_COUNT_REACHED월드 고정 개수의 상한에 도달했습니다.ROOM_INITIALIZATION_FAILED방의 지형·환경·저장 설정 초기화가 실패했습니다.ROOM_NOT_FOUND요청한 활성 방을 찾을 수 없습니다.RPC/BASE/CALL_FAILED계약 호출 중 더 구체적으로 분류되지 않은 실패입니다.RPC/BASE/CONTRACT_CALL_FAILED체인 또는 VM이 계약 실행 실패를 반환했습니다.RPC/BASE/INVALID_QUERY_RESULT계약 조회 응답에 해석에 필요한 필드가 없거나 형식이 다릅니다.RPC/BASE/INVALID_TX_RESULT트랜잭션 결과를 안전하게 판정할 수 있는 응답 형식이 아닙니다.RPC/BASE/QUERY_CONTRACT_FAILED체인 또는 VM이 계약 조회 실패를 반환했습니다.RPC/BASE/QUERY_FAILED계약 조회 중 더 구체적으로 분류되지 않은 실패입니다.RPC/BIOME/GET_BIOME_INFOS_FAILED계약에서 바이옴 정보를 조회하지 못했습니다.RPC/BIOME/GET_BIOME_INFOS_MAP_FAILED바이옴 조회 결과를 식별자별 맵으로 구성하지 못했습니다.RPC/BLOCK/GET_BLOCKS_FROM_TO_FAILED계약에서 지정 범위의 블록을 조회하지 못했습니다.RPC/BLOCK/GET_CURRENT_BLOCK_ID_FAILED계약에서 현재 블록 ID를 조회하지 못했습니다.RPC/WORLD/CREATE_PERSONAL_REALM_FAILED개인 월드 생성 트랜잭션 처리가 실패했습니다.RPC/WORLD/DELETE_PERSONAL_REALM_FAILED개인 월드 삭제 트랜잭션 처리가 실패했습니다.RPC/WORLD/EXPAND_PERSONAL_REALM_FAILED개인 월드 확장 트랜잭션 처리가 실패했습니다.RPC/WORLD/GET_RANDOM_REALMS_FAILED임의 월드 목록을 조회하지 못했습니다.RPC/WORLD/GET_REALM_BY_SLUG_FAILEDslug로 개인 월드를 조회하지 못했습니다.RPC/WORLD/GET_REALM_CREATION_COST_FAILED월드 생성 비용을 조회하지 못했습니다.RPC/WORLD/GET_REALM_EXPANSION_COST_FAILED월드 확장 비용을 조회하지 못했습니다.RPC/WORLD/GET_REALM_SIZE_INFOS_FAILED월드 크기와 단계별 비용 정보를 조회하지 못했습니다.RPC/WORLD/GET_REALMS_BY_OWNER_FAILED소유자 주소로 월드 목록을 조회하지 못했습니다.RPC/WORLD/GET_SYSTEM_REALMS_FAILED시스템 realm 목록을 조회하지 못했습니다.RPC/WORLD/GET_SYSTEM_WORLD_BY_ID_FAILED숫자 ID로 시스템 월드를 조회하지 못했습니다.RPC/WORLD/GET_SYSTEM_WORLD_BY_SLUG_FAILEDslug로 시스템 월드를 조회하지 못했습니다.RPC/WORLD/GET_SYSTEM_WORLDS_FAILED시스템 월드 목록을 조회하지 못했습니다.RPC/WORLD/GRANT_ROLE_FAILED계약에서 월드 역할을 부여하지 못했습니다.RPC/WORLD/REVOKE_ROLE_FAILED계약에서 월드 역할을 회수하지 못했습니다.RPC/WORLD/UPDATE_PERSONAL_REALM_FAILED개인 월드 갱신 트랜잭션 처리가 실패했습니다.RUNTIME/AGGREGATE_ERROR여러 실행 오류가 하나의 AggregateError로 전달되었습니다.RUNTIME/BUFFER_OOB버퍼 접근 범위가 허용 범위를 벗어났습니다.RUNTIME/INITIALIZE_FAILED런타임 초기화가 실패했습니다.RUNTIME/RANGE_ERROR실행 중 값이나 범위가 허용 범위를 벗어났습니다.RUNTIME/REFERENCE_ERROR실행 중 사용할 수 없는 참조에 접근했습니다.RUNTIME/SYNTAX_ERROR실행 또는 파싱 과정에서 문법 오류가 발생했습니다.RUNTIME/TYPE_ERROR실행 중 값의 타입이나 사용 방식이 맞지 않습니다.SOCIAL/FRIENDS_ACCEPT_NOT_ALLOWED현재 상태에서 친구 요청을 수락할 수 없습니다.SOCIAL/FRIENDS_CANCEL_NOT_ALLOWED현재 상태에서 친구 요청을 취소할 수 없습니다.SOCIAL/FRIENDS_CONTEXT_PROCESS_NOT_VALID친구 작업의 처리 맥락이나 상태가 올바르지 않습니다.SOCIAL/FRIENDS_INVITE_NOT_ALLOWED현재 상태에서 친구 요청을 보낼 수 없습니다.SOCIAL/FRIENDS_MAX_COUNT_REACHED친구 수의 상한에 도달했습니다.SOCIAL/FRIENDS_NOT_FOUND친구 관계 또는 요청을 찾을 수 없습니다.SOCIAL/FRIENDS_REJECT_NOT_ALLOWED현재 상태에서 친구 요청을 거절할 수 없습니다.SOCIAL/FRIENDS_UNFRIEND_NOT_ALLOWED현재 상태에서 친구 관계를 해제할 수 없습니다.TERRAIN/CHUNK_FAILED_TO_DECOMPRESS청크 데이터의 압축을 해제하지 못했습니다.TERRAIN/CHUNK_FAILED_TO_GENERATE청크 지형을 생성하지 못했습니다.TERRAIN/CHUNK_FAILED_TO_LOAD_FROM_CACHE캐시에서 청크를 불러오지 못했습니다.TERRAIN/CHUNK_FAILED_TO_LOAD_FROM_STORAGE영속 저장소에서 청크를 불러오지 못했습니다.TERRAIN/CHUNK_INVALID_DECOMPRESSED_BYTES압축 해제한 청크의 바이트 길이나 형식이 올바르지 않습니다.TERRAIN/CHUNK_NOT_FOUND요청한 청크를 찾을 수 없습니다.INVALID_ERROR_ARGUMENTUI 오류 처리에 Error, AppError 또는 Problem으로 해석할 수 없는 값이 전달되었습니다.USER/LOGIN_FAILED사용자 로그인 처리가 실패했습니다.USER/LOOKUP_FAILED사용자 정보를 조회하지 못했습니다.VALIDATION_ERROR요청 입력이 서버 검증을 통과하지 못했습니다.WS/VALIDATION_ERRORWebSocket 메시지의 페이로드가 스키마 검증을 통과하지 못했습니다.

공통 형식과 별도의 처리 정책

HTTP, 소켓, 로컬 앱 오류는 안전한 Problem 정보를 공유할 수 있습니다. 응답 상태, 연결 처리, 복구 정책은 각각 구분합니다. 명령 결과는 타입이 정해진 성공·실패 계약을 유지합니다.

등록된 고정 코드 201개, HTTP 동적 계열 2개, 기존 메시지 키 8개를 다룹니다. 과거 식별자의 오타도 호환성을 위해 유지합니다. 영문 메시지로 판정하지 말고 정확한 코드 값을 검색하세요.